GitOps Deployment of Ilum with Argo CD

Argo CD is a declarative, GitOps continuous delivery tool for Kubernetes. By combining Ilum with Argo CD, you can manage your entire Ilum deployment — including enabling or disabling modules — through Git commits, with Argo CD automatically syncing changes to your cluster.

পূর্বশর্ত ​

• A running Kubernetes cluster (e.g., Minikube, EKS, GKE, AKS)
• কুবেক্টল configured to access your cluster
• A GitHub (or other Git provider) account

Step 1: Start a Kubernetes Cluster​

If you are using Minikube for local development, start a cluster with sufficient resources:

minikube start --cpus 6 --memory 10192 --addons metrics-server

Step 2: Install Argo CD​

Create a dedicated namespace for Argo CD and install it using the official manifests:

# Create the argocd namespace
kubectl create namespace argocd

# Install Argo CD
kubectl apply -n argocd --server-side=true \
  -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

Verify that all Argo CD pods are running:

kubectl -n argocd get po

You should see pods like argocd-server, argocd-application-controller, argocd-repo-server, argocd-redisএবং argocd-dex-server, all in a Runningঅবস্থা।

Access the Argo CD UI​

Port-forward the Argo CD server to access the web UI:

kubectl port-forward svc/argocd-server -n argocd 8080:443

Open your browser and navigate to https://localhost:8080.

Retrieve the Admin Password​

The default username is অ্যাডমিন . Retrieve the initial password with:

kubectl -n argocd get secret argocd-initial-admin-secret \
  -o jsonpath="{.data.password}" | base64 --decode; echo

Log in to the Argo CD UI with these credentials.

Step 3: Prepare the Git Repository​

Create a new Git repository (e.g., IlumArgoDeployment) to store your deployment configuration. This repository will contain two files:

3.1 Application Manifest (app-prod.yaml) ​

This is the Argo CD প্রয়োগ resource that tells Argo CD how to deploy Ilum:

apiVersion :  argoproj.io/v1alpha1
প্রকার : প্রয়োগ 
মেটাডেটা : 
  নাম : ইলুম - prod
  নামস্থান :  argocd
স্পেসিফিকেশন : 
  প্রকল্প : ডিফল্ট 
  destination: 
    সার্ভার : এইচটিটিপিএস : //kubernetes.default.svc
    নামস্থান : ইলুম - prod
  sources: 
    # Chart from repo
    -  chart: ইলুম 
      repoURL: এইচটিটিপিএস : //charts.ilum.cloud
      targetRevision:  6.6.1
      helm: 
        valueFiles: 
          -  $values/values- prod.yaml
    # Values from Git
    -  repoURL: এইচটিটিপিএস : //github.com/<your- org> /IlumArgoDeployment
      targetRevision: মাথা 
      রেফ : মানসমূহ 
  syncPolicy: 
    automated: 
      prune:  সত্য 
      selfHeal:  সত্য 
    syncOptions: 
      -  CreateNamespace=true

Key fields:

3.2 Values File (values-prod.yaml) ​

This file contains Helm value overrides for your Ilum deployment. Start with modules disabled and enable them as needed:

ilum-jupyter: 
  সক্ষম :  মিথ্যা 

গিটিয়া : 
  সক্ষম :  মিথ্যা 

postgresql: 
  সক্ষম :  মিথ্যা 

postgresExtensions: 
  সক্ষম :  মিথ্যা 

Commit both files to your repository.

Step 4: Deploy the Application​

Apply the Argo CD Application manifest to your cluster:

kubectl apply -f https://raw.githubusercontent.com/<your-org>/IlumArgoDeployment/main/app-prod.yaml \
  -n argocd

Alternatively, if you have the file locally:

kubectl apply -f app-prod.yaml -n argocd

Verify Deployment​

Check that the namespace was created and pods are starting:

# Check namespaces
kubectl get ns

# Watch pods in the ilum-prod namespace
kubectl -n ilum-prod get po

You should see the ilum-prod namespace appear and core Ilum pods (like ইলুম-কোর , ইলুম-ইউআই , ilum-minio, ilum-mongodb, ilum-openldap) initializing.

Step 5: Monitor in Argo CD UI​

In the Argo CD web interface, you will see the ilum-prod application. The UI provides:

• Sync Status: Shows whether the deployed state matches the desired state in Git (Syncedবা OutOfSync).
• Health Status: Shows the overall health of the application (Healthy, Progressingবা Degraded).
• Tree View: A visual representation of all Kubernetes resources managed by the application (Deployments, ReplicaSets, Pods, ConfigMaps, Services, etc.).
• Resource Details: Click on any resource to see its summary, events, logs, and live manifest.

Step 6: Access the Ilum UI​

Once all pods are in a Running state, port-forward the Ilum UI service:

kubectl port-forward svc/ilum-ui -n ilum-prod 9777:9777

Open http://localhost:9777 in your browser to access the Ilum login page.

Step 7: Manage Ilum Modules via Git​

The real power of GitOps is managing your deployment through Git commits. To enable or disable Ilum modules, simply edit the values-prod.yaml file in your repository.

Example: Enable Jupyter​

সম্পাদনা values-prod.yaml and change ilum-jupyter.enabled করতে সত্য :

ilum-jupyter: 
  সক্ষম :  সত্য 

গিটিয়া : 
  সক্ষম :  মিথ্যা 

postgresql: 
  সক্ষম :  মিথ্যা 

postgresExtensions: 
  সক্ষম :  মিথ্যা 

Commit the change with a descriptive message (e.g., "Enable jupyter in ilum production") and push to the main branch.

Argo CD will automatically detect the change, mark the application as OutOfSync, and trigger a sync operation. You can watch the new ilum-jupyter pod being created in both the Argo CD UI and via কুবেক্টল .

Example: Enable All Modules​

To enable Gitea (built-in Git server), PostgreSQL, and PostgreSQL Extensions alongside Jupyter:

ilum-jupyter: 
  সক্ষম :  সত্য 

গিটিয়া : 
  সক্ষম :  সত্য 

postgresql: 
  সক্ষম :  সত্য 

postgresExtensions: 
  সক্ষম :  সত্য 

Commit and push. Argo CD will sync and deploy all the additional pods (PostgreSQL, Gitea, Jupyter, etc.). You can monitor the progress in the Argo CD UI — the Events tab shows a detailed log of all sync operations.

Once healthy, the Ilum UI sidebar will show all enabled modules: মিনিয়াম , জুপিটার , গীতিয়া , and more.

সমস্যা সমাধান ​

kubectl -n ilum-prod get po -w

kubectl -n ilum-prod logs <pod-name>

Frequently Asked Questions (FAQ)​