You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 

2.6 KiB

CLOUD-AGENT(8) - System Manager's Manual

NAME

cloud-agent - cloud provisioning for OpenBSD VMs

SYNOPSIS

cloud-agent [-nuv] [-c cloud[,cloud...]] [-p length] [-r rootdisk] [-t timeout] [-U username] interface

DESCRIPTION

The cloud-agent program manages the OpenBSD provisioning and VM interaction in cloud environments.

The options are as follows:

-c cloud[,cloud...]

Probe a list of cloud stacks for provisioning in the specified order. If this option is not specified, cloud-agent tries to detect the environment and possible cloud stacks automatically. Supported cloud stacks are:

azure

Microsoft Azure

cloudinit

Generic cloud-init

ec2

Amazon AWS EC2

opennebula

OpenNebula

openstack

OpenStack

-p length

Generate and set a random password for the default user. The password will be written in its plain form into the ~/.ssh/authorized_keys file. This allows to use the doas(1) command to gain root privileges. The minimum length is 8 characters and the default is an empty password.

-n

Do not configure the system and skip the provisioning step.

-t timeout

Change the HTTP timeout. The default is 3 seconds.

-U username

Change the default user. The default is "ec2-user" on AWS, "azure-user" on Azure, and "puffy" everywhere else. The default user is used when it is not obtained from the cloud configuration. Using "root" is supported, but not recommended.

-r rootdisk

Automatically grow the last OpenBSD FFS partition of the root disk to use all the available space.

-u

Deprovision and unconfigure the system. This deletes keys, passwords, and logs files without asking for permission.

-v

Produce more verbose output.

Enable cloud-agent in the hostname.if(5) of the VM's primary networking interface and automatically the last partition of the root disk:

# cat /etc/hostname.hvn0
dhcp
!/usr/local/libexec/cloud-agent -r sd0 "\$if"

FILES

~/.ssh/authorized_keys

The location of the agent-configured SSH public keys and optional password.

/usr/local/libexec/cloud-agent

The agent itself.

/usr/local/bin/cms

The CMS binary that is used to decrypt messages from the Azure fabric.

/var/db/cloud-instance

The instance ID as reported by the cloud. cloud-agent reprovisions the system when the value has changed.

SEE ALSO

meta-data(8), vmd(8)

AUTHORS

Reyk Floeter <reyk@openbsd.org>

OpenBSD 6.5 - June 26, 2019