2017-06-29 10:08:38 +00:00
|
|
|
cloud-agent for OpenBSD
|
|
|
|
=======================
|
2017-06-29 09:40:48 +00:00
|
|
|
|
2017-06-29 10:08:38 +00:00
|
|
|
This is a simple OpenBSD-specific agent that aims to handle
|
|
|
|
provisioning and cloud initialization on public clouds such as
|
|
|
|
Microsoft Azure and Amazon AWS. For OpenBSD on Azure, it is a minimal
|
|
|
|
alternative to the [WALinuxAgent](https://github.com/Azure/WALinuxAgent/).
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
-------------
|
|
|
|
|
|
|
|
* OpenBSD 6.1 or higher, nothing else.
|
|
|
|
|
|
|
|
Files
|
|
|
|
-----
|
|
|
|
|
|
|
|
* `/usr/local/libexec/cloud-agent`
|
|
|
|
* `/usr/local/bin/cms`
|
|
|
|
|
|
|
|
The CMS binary is a port of OpenSSL's CMS tool to LibreSSL. LibreSSL
|
|
|
|
has removed CMS which is required by Azure.
|
|
|
|
|
|
|
|
Usage
|
|
|
|
-----
|
|
|
|
|
2019-06-05 20:12:42 +00:00
|
|
|
See the [cloud-agent(8)](cloud-agent.md) documentation for more
|
|
|
|
information about the usage.
|
|
|
|
|
|
|
|
Basic installation is easy, `cloud-agent` detects the cloud type
|
|
|
|
automatically.
|
2017-06-29 10:08:38 +00:00
|
|
|
|
|
|
|
* On Microsoft Azure, create a file `/etc/hostname.hvn0`
|
|
|
|
|
|
|
|
* On Amazon AWS, create a file `/etc/hostname.xnf0`
|
|
|
|
|
2019-06-11 13:11:28 +00:00
|
|
|
* On CloudStack, such as Exoscale, create a file `/etc/hostname.vio0`
|
2018-05-15 21:37:46 +00:00
|
|
|
|
2017-06-29 10:08:38 +00:00
|
|
|
* On OpenBSD VMM (with meta-data), create a file `/etc/hostname.vio0`
|
|
|
|
|
2018-05-15 21:37:46 +00:00
|
|
|
* On OpenStack/VMware, create a file `/etc/hostname.vmx0`
|
|
|
|
|
2019-06-11 13:11:28 +00:00
|
|
|
* The content of the file is identical for all of the above:
|
2017-06-29 10:08:38 +00:00
|
|
|
|
|
|
|
dhcp
|
|
|
|
!/usr/local/libexec/cloud-agent "\$if"
|
|
|
|
|
2019-06-11 13:11:28 +00:00
|
|
|
* On OpenNebula, such as Data Center Light, create a file `/etc/hostname.if`
|
|
|
|
where _if_ is the name of your primary interface.
|
|
|
|
The `dhcp` line should be ommitted in the file:
|
|
|
|
|
|
|
|
!/usr/local/libexec/cloud-agent "\$if"
|
|
|
|
|
|
|
|
Releases
|
|
|
|
--------
|
|
|
|
|
|
|
|
See the [Changelog](CHANGELOG.md) for a summary of changes and
|
|
|
|
download the releases from the
|
|
|
|
[release page](https://github.com/reyk/cloud-agent/releases).
|
|
|
|
|
2017-06-29 10:08:38 +00:00
|
|
|
Author
|
|
|
|
------
|
|
|
|
|
|
|
|
[Reyk Floeter](https://github.com/reyk/).
|
|
|
|
|
2017-06-29 10:11:07 +00:00
|
|
|
See the [License](LICENSE.md) file for more information.
|