Skip to content

Latest commit

 

History

History
86 lines (49 loc) · 3.56 KB

production.md

File metadata and controls

86 lines (49 loc) · 3.56 KB
Raw

Deployment in production on Kubernetes

Requirements

To deploy application on a local Kubernetes cluster, for development and testing purposes, install:

Deploy locally to minikube

Basic usage

To start the cluster:

minikube start --addons registry --addons metrics-server --addons dashboard

If errors are encountered during minikube start, before starting it again run:

minikube delete

To start proxy in foreground and get Kubernetes Dashboard URL:

minikube dashboard --url

List pods with kubectl:

kubectl get pods --all-namespaces=true

Build and push production Docker image of the application

On GNU/Linux and macOS, to point your terminal to use the docker daemon inside minikube run this:

eval $(minikube docker-env)

Now any docker command you run in this current terminal will run against the docker inside minikube cluster. For detailed explanation and instructions for Windows visit official minikube documentation.

To build production Docker image for the application, from the project root, execute:

docker build --tag localhost:5000/php --target frankenphp_prod .

Push the image to the Docker registry installed in minikube:

docker push localhost:5000/php

Deploy

To fetch Helm chart dependencies, from the project root, execute following as a single command:

helm repo add bitnami https://charts.bitnami.com/bitnami/ \
    && helm repo add jouve https://jouve.github.io/charts/ \
    && helm dependency build etc/helm/dolphin

Deploy the project using the Helm chart by running, as a single command, from the project root:

helm upgrade --install dolphin etc/helm/dolphin \
    --set php.image.repository=localhost:5000/php \
    --set php.image.tag=latest

Copy and paste the commands displayed in the terminal to enable the port forwarding then go to http://localhost:8080 to access the application running in minikube cluster. Give it some time to start.

Mailpit

To access Mailpit which is running inside minikube execute commands:

export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=mailpit,app.kubernetes.io/instance=dolphin" -o jsonpath="{.items[0].metadata.name}")
export CONTAINER_PORT=$(kubectl get pod --namespace default $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
kubectl --namespace default port-forward $POD_NAME 8026:$CONTAINER_PORT

It will be available at http://127.0.0.1:8026/.

RabbitMQ Management (UI)

To access RabbitMQ Management which is running inside minikube execute commands:

export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=rabbitmq,app.kubernetes.io/instance=dolphin" -o jsonpath="{.items[0].metadata.name}")
export CONTAINER_PORT=$(kubectl get pod --namespace default $POD_NAME -o jsonpath="{.spec.containers[0].ports[2].containerPort}")
kubectl --namespace default port-forward $POD_NAME 15673:$CONTAINER_PORT

It will be available at http://127.0.0.1:15673/.

Credentials:

  • Username: admin
  • Password: !ChangeMe!