Add cloud-agent(8) as markdown file

This commit is contained in:
reykfloeter 2019-06-05 22:12:42 +02:00
parent 3be9707418
commit ba34eb76dd
2 changed files with 124 additions and 1 deletions

View File

@ -23,7 +23,11 @@ has removed CMS which is required by Azure.
Installation is easy, `cloud-agent` detects the cloud type automatically.
See the [cloud-agent(8)]( documentation for more
information about the usage.
Basic installation is easy, `cloud-agent` detects the cloud type
* On Microsoft Azure, create a file `/etc/hostname.hvn0`

119 Normal file
View File

@ -0,0 +1,119 @@
CLOUD-AGENT(8) - System Manager's Manual
**cloud-agent** - cloud provisioning for OpenBSD VMs
\[**-p** *length*]
\[**-r** *rootdisk*]
\[**-t** *timeout*]
\[**-U** *username*]
program manages the OpenBSD provisioning and VM interaction in cloud
environments, including Microsoft Azure and Amazon AWS.
The options are as follows:
**-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.
> 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.
> Deprovision and unconfigure the system.
> This deletes keys, passwords, and logs files without asking for permission.
> Produce more verbose output.
in the
of the VM's primary networking interface and automatically the last
partition of the root disk:
# cat /etc/hostname.hvn0
!/usr/local/libexec/cloud-agent -r sd0 "\$if"
> The location of the agent-configured SSH public keys and optional password.
> The agent itself.
> The CMS binary that is used to decrypt messages from the Azure fabric.
> The instance ID as reported by the cloud.
> **cloud-agent**
> reprovisions the system when the value has changed.
Reyk Floeter <[](>
OpenBSD 6.5 - June 5, 2019