Migrating Docker Compose to Kubernetes#
Migrating Docker Compose to Kubernetes.
To migrate docker compose to kubernetes complete the following steps:
-
Export the existing Docker Compose MongoDB database.
-
Navigate to MongoDB database container shell.
docker exec -it <mongo_db_service> bash
-
Export all data from the MongoDB database.
mongodump
-
Exit the MongoDB database container shell.
exit
-
Copy the dump folder out of the MongoDB database container.
docker cp <mongo_db_service>:/dump <DESTINATION>
The MongoDB export is used in the final step.
-
-
Install MongoDB database in Kubernetes.
-
Install the MongoDB Helm chart with a root password of your choice.
helm install --set mongodbRootPassword=<ROOT_PASSWORD> --name velocity-mongo stable/mongodb
-
-
Create a non-root MongoDB user
-
Navigate to MongoDB database's Kubernetes pod..
kubectl exec -it --namespace default svc/accelerate-mongo-mongodb /bin/bash
-
Open a MongoDB Shell session as the root user.
mongo admin -u root -p <ROOT_PASSWORD>
-
Create a non-root MongoDB user with the following roles and permissions.
db.createUser ({ user: "<NEW_USERNAME>", pwd: "<NEW_PASSWORD>", roles: [{role: "readWriteAnyDatabase", db: "admin"}, {role: "dbAdminAnyDatabase", db: "admin"}, {role: "clusterAdmin", db: "admin" }]})
-
Exit the MongoDB Shell.
exit
-
-
Restore the Docker Compose database dump to the new MongoDB pod.
-
Use
kubectl get pods
to get all pods. Identify the MongoDB pod. -
Copy database dump folder from the Docker Compose installation location into the MongoDB pod.
kubectl cp <DUMP_LOCATION> <FULL_POD_NAME>:/tmp/dump
-
Navigate to MongoDB pod shell.
kubectl exec -it --namespace default svc/accelerate-mongo-mongodb /bin/bash
-
Change directory to dump directory.
cd /tmp/dump
-
List all MongoDB folder to verify the contents.
ls
Note: Each folder is a database in MongoDB.
-
Restore all database except
ADMIN
mongorestore --uri="mongodb://<NEW_USERNAME>:<NEW_PASSWORD>@localhost:27017/?authSource=admin" <DB_NAME> -d <DB_NAME>
Note: Delete the Docker Compose MongoDB export that was copied into the Kubermetes MongoDB pod at your earliest convenience.
-
Exit MongoDB pod shell.
exit
The new MongoDB server is ready for use. For Kubernetes installation directions, see this page.
-
-
Configure SSL certificate.
-
Create a
accelerate-secret.yml file
with the following contents.apiVersion: v1 data: tls.crt: <BASE64_CERT> tls.key: <BASE64_KEY> kind: Secret metadata: name: acceleratetls namespace: default type: Opaque
-
Encode the certificate and key files.
cat <FILE>.pem | base64
Save certificate and key files to the required folders.
-
Apply the
accelerate-secret.yml
file.kubectl apply -f accelerate-secret.yml
-
-
Configure Kubernetes Ingress.
Apply mandatory and cloud-generic Ingress-Nginx.yml files.
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.30.0/deploy/static/mandatory.yaml
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.30.0/deploy/static/provider/cloud-generic.yaml
-
Install HCL Accelerate.
Before you begin, ensure
settings.json
file is available in ~/.ucv directory.-
Run
the accelerate installer. All fields taken information fromsettings.json
.Select
kubernetes
platform to generateHelm chart tgz
. -
Use
Helm chart tgz
to install accelerate. -
Install HCL Accelerate.
helm install --set license=accept --set url.domain=<HOSTNAME> --set mongo.url=mongodb://<NEW_USERNAME>:<NEW_PASSWORD>@velocity-mongo-mongodb:27017/?authSource=admin --name accelerate <ACCELERATE_HELM_CHART>
-
Parent topic: Migrating