Skip to main content

Manual Components Installation

Use this guide to manually install AI/Run CodeMie components one by one.

info

Manual steps are not mandatory if you chose the automated helm-charts.sh script.

Component Installation Order​

This guide covers installation of the following components in order:

  1. Storage and Ingress (if needed)

    • AWS gp3 Storage Class
    • Nginx Ingress Controller

  2. Data Layer

    • Elasticsearch
    • Postgres-operator
    • PostgreSQL secret for RDS

  3. Security and Identity

    • Keycloak-operator
    • Keycloak
    • OAuth2 Proxy

  4. Plugin Engine

    • NATS
    • NATS Auth Callout

  5. AI/Run CodeMie Core

    • CodeMie API
    • CodeMie UI
    • MCP Connect
    • Mermaid Server

  6. Observability

    • Fluent Bit
    • Kibana
    • Kibana Dashboards

Prerequisites Setup​

Container Registry Access​

Before deploying AI/Run CodeMie components, set up pull secrets:

  1. Obtain key.json file from AI/Run CodeMie team

  2. Create the codemie namespace:

    kubectl create namespace codemie

  3. Configure the secret:

    kubectl create secret docker-registry gcp-artifact-registry \
      --docker-server=https://europe-west3-docker.pkg.dev \
      --docker-email=gsa-%%PROJECT_NAME%%-to-gcr@or2-msq-epmd-edp-anthos-t1iylu.iam.gserviceaccount.com \
      --docker-username=_json_key \
      --docker-password="$(cat key.json)" \
      -n codemie

  4. Reference the secret in deployments:

    imagePullSecrets:
      - name: gcp-artifact-registry

Container Registry Login​

Login to AI/Run CodeMie container registry:

export GOOGLE_APPLICATION_CREDENTIALS=key.json
gcloud auth application-default print-access-token | helm registry login -u oauth2accesstoken --password-stdin https://europe-west3-docker.pkg.dev

Next Steps​

Follow the installation guide in the order listed above, starting with Storage and Ingress.