Skip to main content

Bubble policies

Isolated networks that test failovers run in. Operator only.

bubble policy create​

Register a bubble policy: how a test's isolated bubble is built (operator).

openstack backup bubble policy create <name> --project <project> \
--network-cidr <cidr> [--strict] [--no-strict] [--jump-host] \
[--no-jump-host] [--jump-host-image <image>] \
[--jump-host-flavor <flavor>] [--max-duration <duration>] \
[--permitted-check <check>] [--isolation-canary <host:port>]
ArgumentDescription
<name>Policy name, unique on this cloud.
--project <project>Operator project every bubble under this policy is built in; never a tenant's. Required.
--network-cidr <cidr>Range a bubble's networks are allocated from (repeatable; given on set, replaces the list) Required.
--strictForbid any router, external gateway or floating IP on a bubble's networks (the default for a new policy)
--no-strictAllow routers and floating IPs on a bubble's networks.
--jump-hostBuild a jump host in each bubble, which runs the health checks and tries the canaries (the default for a new policy)
--no-jump-hostBuild no jump host.
--jump-host-image <image>Image the jump host boots; the service's probe image when not set.
--jump-host-flavor <flavor>Flavor of the jump host; the service's probe flavor when not set.
--max-duration <duration>How long a bubble may stand before it is torn down, from 10m to 168h, e.g. 2h; 1h for a new policy.
--permitted-check <check>Health check a test may run, tcp or http (repeatable; given on set, replaces the list) One of tcp, http.
--isolation-canary <host:port>Address a bubble must not reach; the jump host tries it before any member boots (repeatable; given on set, replaces the list)

bubble policy delete​

Delete bubble policies no registration names and no test ran under (operator).

openstack backup bubble policy delete <bubble-policy> [<bubble-policy> ...]
ArgumentDescription
<bubble-policy>Bubble policy name or id. Takes one or more.

bubble policy list​

List the bubble policies a test failover can run under.

openstack backup bubble policy list

bubble policy set​

Change a bubble policy; only the options given change (operator).

openstack backup bubble policy set <bubble-policy> [--name <name>] \
[--project <project>] [--network-cidr <cidr>] [--strict] [--no-strict] \
[--jump-host] [--no-jump-host] [--jump-host-image <image>] \
[--jump-host-flavor <flavor>] [--max-duration <duration>] \
[--permitted-check <check>] [--isolation-canary <host:port>] \
[--no-isolation-canary]
ArgumentDescription
<bubble-policy>Bubble policy name or id.
--name <name>New name.
--project <project>Operator project every bubble under this policy is built in; never a tenant's.
--network-cidr <cidr>Range a bubble's networks are allocated from (repeatable; given on set, replaces the list)
--strictForbid any router, external gateway or floating IP on a bubble's networks (the default for a new policy)
--no-strictAllow routers and floating IPs on a bubble's networks.
--jump-hostBuild a jump host in each bubble, which runs the health checks and tries the canaries (the default for a new policy)
--no-jump-hostBuild no jump host.
--jump-host-image <image>Image the jump host boots; the service's probe image when not set.
--jump-host-flavor <flavor>Flavor of the jump host; the service's probe flavor when not set.
--max-duration <duration>How long a bubble may stand before it is torn down, from 10m to 168h, e.g. 2h; 1h for a new policy.
--permitted-check <check>Health check a test may run, tcp or http (repeatable; given on set, replaces the list) One of tcp, http.
--isolation-canary <host:port>Address a bubble must not reach; the jump host tries it before any member boots (repeatable; given on set, replaces the list)
--no-isolation-canaryClear the isolation canaries.