adcm-cluster-deploy

Deploying a test cluster

Establish the instance and the hosts before touching anything

There is no default instance and no default host list. Both come from the resolved settings (adcm-connection) or from the user:

ADCM_SCRIPTS="${CLAUDE_PLUGIN_ROOT}/scripts"
ADCM="python3 $ADCM_SCRIPTS/adcmctl.py"

$ADCM whoami                 # which instance, as whom
$ADCM hosts --free           # what is actually available to deploy on

If deploy.hosts is set in the config file, those are the hosts you may use. If it is not, ask which hosts to use — or pass --count N and let the tool take free ones, and say in your report which it took. Never assume a host name, and never take a host that belongs to another cluster: add-hosts refuses, and that refusal is correct.

Registering hosts and hostproviders is out of scope. If there is no free capacity, that is a message for the instance owner, not a problem to work around.

The sequence

Every step prints what it did and records ids in <repo>/.adcm/state.json, so later steps need no arguments.

# 0. the bundle: whatever was last uploaded, or upload the last build now
$ADCM bundles --mine
$ADCM upload                                   # uses last_build from state

# 1. prototype and licence
$ADCM prototype --type cluster                 # note the id and the licence status
$ADCM accept-license <prototypeId>             # only when status is "unaccepted"

# 2. cluster — name defaults to <deploy.cluster_prefix or $USER>-MMDD-HHMM
$ADCM create-cluster --prototype-id <id>

# 3. services — all of the bundle's, or a subset
$ADCM add-services --cluster <clusterId>
$ADCM add-services --cluster <clusterId> --names svc_a,svc_b

# 4. hosts
$ADCM add-hosts --cluster <clusterId> --names <host,host>   # or --count 2

# 5. mapping — satisfies each component's minimum across the attached hosts
$ADCM map --cluster <clusterId>                # add --optional for [0,n] components
$ADCM show-mapping --cluster <clusterId>

# 6. configuration — see below
$ADCM concerns --cluster <clusterId>

# 7. install, and watch it
$ADCM run-action --cluster <clusterId> --name install --wait