Collection of simple applications for Learning By Doing across different XaaS (Anything as a Service) stacks and cloud infrastructures.
1) First of all clone this repository:
$ git clone git@github.com:frugan-dev/lbd-xaas.git
$ cd lbd-xaas2) Copy and rename these files:
src/.env.dist -> src/.env
src/private/app/.env.dist -> src/private/app/.env
and edit them according to your needs.
Requirements
Installation
1) Create local CA with mkcert:
$ mkcert -install2) Run install script:
$ cd src
$ sudo chmod +x install.sh
$ ./install.sh
$ docker compose up -d3) Capture the Docker PHP-FPM container logs:
$ docker compose logs -f php-fpmand wait until all initialization operations are completed.
4) Browse via HTTPS to the following address https://localhost.
5) Stop, delete everything and return to parent folder:
$ docker compose down
$ docker system prune --all
$ cd ../Requirements
Installation
Note: PHP v8.2 is used, instead of v8.3, because at the time of writing the following error message appears:
RuntimeError: Unknown runtime 'php83'; supported runtimes are 'go119', 'go120', 'go121', 'go122', 'php81', 'php82', 'python310', 'python311', 'python312', 'python38', 'python39'.
1) Run deploy script:
$ cd gae-standard
$ sudo chmod +x deploy.sh
$ ./deploy.sh2) Capture the Docker container logs:
$ docker compose logs -f localand wait until all initialization operations are completed.
3) Browse the application via HTTP to the following address http://localhost:8080.
4) Browse the administration console via HTTP to the following address http://localhost:8000.
5) Stop, delete everything and return to parent folder:
$ docker compose down
$ docker system prune --all
$ cd ../Requirements
Installation
Note: at the time of writing, despite having followed the official documentation, this stack does not work and the following error message appears:
In env: flex, only the following runtimes are allowed: ('python-compat', 'go', 'custom')
1) Run deploy script:
$ cd gae-flexible
$ sudo chmod +x deploy.sh
$ ./deploy.sh2) Capture the Docker container logs:
$ docker compose logs -f localand wait until all initialization operations are completed.
3) Browse the application via HTTP to the following address http://localhost:8080.
4) Browse the administration console via HTTP to the following address http://localhost:8000.
5) Stop, delete everything and return to parent folder:
$ docker compose down
$ docker system prune --all
$ cd ../Installation
1) Create stateful-app image in your Docker local registry:
$ DOCKER_BUILDKIT=1 docker build \
-f k8s-stateful/Dockerfile \
-t registry.local/stateful-app:latest \
.Note: about DOCKER_BUILDKIT=1 see here https://stackoverflow.com/a/57774684/3929620.
2) Verify that the image was created correctly in Docker local registry:
$ docker image ls3) Start Minikube cluster:
$ minikube start4) Push Docker local image to Minikube local registry:
$ minikube image load registry.local/stateful-app5) Verify that the image was created correctly in Minikube local registry:
$ minikube image ls6) Apply resources from Kustomize configurations:
$ kubectl apply -k ./k8s-stateful7) Verify that all pods are in Running state:
$ kubectl get pods8) Get the NodePort using the service command:
$ minikube service stateful-app-service --url9) Browse via HTTP to the address returned (e.g. http://192.168.0.0:12345).
10) Stop and delete everything:
$ kubectl delete -k ./k8s-stateful
$ minikube image rm registry.local/stateful-app
$ minikube image rm docker.io/bitnami/apache
$ minikube stop
$ minikube delete
$ docker system prune --allInstallation
1) Create stateless-app image in your Docker local registry:
$ DOCKER_BUILDKIT=1 docker build \
--secret id=.env,src=$PWD/src/.env \
-f k8s-stateless/Dockerfile \
-t registry.local/stateless-app:latest \
.Note: about DOCKER_BUILDKIT=1 see here https://stackoverflow.com/a/57774684/3929620.
2) Verify that the image was created correctly in Docker local registry:
$ docker image ls3) Start Minikube cluster:
$ minikube start4) Push Docker local image to Minikube local registry:
$ minikube image load registry.local/stateless-app5) Verify that the image was created correctly in Minikube local registry:
$ minikube image ls6) Apply resources from Kustomize configurations:
$ kubectl apply -k ./k8s-stateless7) Verify that all pods are in Running state:
$ kubectl get pods8) Get the NodePort using the service command:
$ minikube service stateless-app-service --url9) Browse via HTTP to the address returned (e.g. http://192.168.0.0:12345).
10) Stop and delete everything:
$ kubectl delete -k ./k8s-stateless
$ minikube image rm registry.local/stateless-app
$ minikube stop
$ minikube delete
$ docker system prune --allDocker use root user/group in host machine
1) Get your Unix user/group informations:
$ id2) Add this to /etc/subuid:
{USER}:{UID}:1
...3) Add this to /etc/subgid:
{USER}:{DOCKER_GUI}:1
...4) Add this to /etc/docker/daemon.json:
{
"userns-remap": "{USER}"
} to enable Docker's user namespace feature.
5) Restart Docker engine:
$ sudo service docker restartMore info:
- https://jtreminio.com/blog/running-docker-containers-as-current-host-user/
- https://www.jujens.eu/posts/en/2017/Jul/02/docker-userns-remap/
- https://medium.com/faun/set-current-host-user-for-docker-container-4e521cef9ffc
- https://daten-und-bass.io/blog/docker-user-namespaces-enabling-userns-remap-on-docker-toolbox/
- https://stackoverflow.com/a/49600083
See LINKS file.
See auto-CHANGELOG file.
For your contributions please use:
