agentregistry
Agents
Deploy
Kubernetes

Kubernetes

Deploy your agent to a Kubernetes cluster.

Before you begin

  1. Follow the Get started guide to set up agentregistry and start the agentregistry daemon.

  2. Publish an agent.

  3. Create a Kubernetes cluster. For example, you can use the following command to create a kind cluster.

    kind create cluster --name agentregistry

  4. Make sure that your current kubeconfig context points to the cluster that you want to use.

    kubectl config get-contexts

  5. Follow the Quickstart in the kagent OSS documentation. Agentregistry uses kagent for bootstrapping during an agent deployment.

  6. Local setups only: If you built the docker images locally without pushing them to a registry, load the agent and MCP server images to your kind or minikube cluster. The following command assumes that you use kind and that your cluster is named agentregistry.

    kind load docker-image ghcr.io/myagent:latest --name agentregistry
kind load docker-image my-mcp-server:latest --name agentregistry

Deploy the agent

  1. Deploy the agent to your cluster.

    arctl deployments create myagent \
 --type agent \
 --provider-id kubernetes-default \
 --namespace default

    Example output:

    Waiting for agent 'myagent' to become ready...
Agent 'myagent' version 'latest' deployed to providerId=kubernetes-default in namespace 'default'
    If the deployment fails, a deployment entry is still created in the database and set to failed. You can view failed deployments by using the arctl deployments list command. Note that you cannot re-deploy a failed deployment to fix it. Instead, remove the failed deployment with arctl deployments delete <deployment-ID> and then re-run the arctl deployments create command.

  2. Verify that the agent is up and running.

    kubectl get pods | grep myagent

    Example output:

    NAME                              READY   STATUS    RESTARTS   AGE
myagent-latest-687c4c88b9-xwjzx   1/1     Running   0          10s

  3. Optional: Verify the Agent and, if applicable, the MCPServer resources that were deployed to your cluster.

    kubectl get agent -o yaml
kubectl get mcpserver -o yaml

Cleanup

You can remove a deployment from the UI or CLI.

  1. Open the agentregistry UI and go to the Deployed view.
  2. Find the MCP server deployment that you want to remove and click the trash icon.

  1. List the deployments in your environment and find the one that you want to delete.

    arctl deployments list

  2. Remove the deployment.

    arctl deployments delete <deployment-ID>
Local