Admiral

Connect a cluster

Sign up, install the CLI, and run a Kubernetes agent in a local kind cluster

In this step you connect a Kubernetes cluster to Admiral by running a Kubernetes agent inside it. We use a local kind cluster so you need no cloud account.

1. Sign up and log in

2. Install the CLI

3. Create a local cluster

kind create cluster --name admiral-demo
kubectl cluster-info --context kind-admiral-demo

4. Register and run the agent

Register the agent with Admiral

Registering yields a token the agent uses to authenticate when it pulls work.

admiral agent register --kind kubernetes --name admiral-demo
  1. Open Agents on the web.
  2. Choose New agent, kind Kubernetes.
  3. Copy the issued token for the next step.

Install the agent into the cluster

# TODO: one-command, token-in agent install into the current kube-context
admiral agent install --token <TOKEN>

The web UI shows a copy-paste install command after you register the agent.

5. Verify it connected

admiral agent list

A healthy agent reports a recent heartbeat.

The agent shows as connected in the Agents list once it dials in.

Next

2. Applications & environments

Create a source, an app, and dev + prod environments

Overview

Run a real deploy and a dev-to-prod promotion in about 20 minutes

Applications & environments

Create a source, an application, and dev + prod environments

On this page

1. Sign up and log in2. Install the CLI3. Create a local cluster4. Register and run the agentRegister the agent with AdmiralInstall the agent into the cluster5. Verify it connectedNext