Skip to main content
You can deploy container images with mogenius from any public or private container registry. To get started, click Add Resource on your workspace dashboard and select Container image.

​
Creating a deployment

On the following page, enter the settings for the container image you want to deploy:
  • Name: The name of the deployment. This can’t be changed later.
  • Kind: By default this is set to Deployment. You can change it to DaemonSet or StatefulSet.
  • Namespace: The namespace where your workload should run.
  • Container image: The URL of your container image and tag. By default, this field accepts images from Docker Hub (e.g. nginx:latest), but you can enter container image URLs from any registry. Note that if your image is private, you’ll need to define an image pull secret below.
  • Container Settings: Define image commands and arguments that your container should execute when started.
  • Image Pull Secret: If your image is private, authentication is done through credentials stored in an image pull secret on your Kubernetes cluster. You can either select an existing one, or create a new secret by entering a secret name, registry URL, user, and access token.
  • YAML manifest: At the end, you can preview and modify the manifest that will be deployed to the cluster. You can adjust resource limits, environment variables, and other settings directly in the YAML before deploying.
Click Create and the mogenius operator will deploy the container image to your cluster.

​
After deployment

Once your deployment is created, it appears on your workspace dashboard and you can manage it from there:
  • Monitor your application’s status, resource consumption, logs, and events on the deployment detail page. See Monitoring and Logs for details.
  • Configure environment variables, secrets, health checks, scaling, update strategies, and resource limits in the deployment settings. See Deployment Configuration for a full guide.
  • View dependencies using the topology view on the detail page, which shows related resources like Services, Ingress, ConfigMaps, and Secrets.

​
Programmatic deployment options

Deploying through the UI is the quickest way to get started. For automated and production workflows, mogenius offers several programmatic options:
  • Pipeline Starters (CI/CD): Automatically build and deploy from a Git repository using GitHub Actions. See Pipeline Starters.
  • GitOps: Enable declarative, Git-based deployment management with ArgoCD. Manifests are auto-generated from the UI and synced through Git. See GitOps.
  • API: Update container images programmatically from custom CI pipelines using the set-image API.
  • GitHub Actions templates: Use pre-built workflow templates from the mogenius build-workflows repository for custom CI/CD integrations.