cloud-agent/README.md

52 lines
1.2 KiB
Markdown
Raw Normal View History

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
-----
Installation is easy, `cloud-agent` detects the cloud type automatically.
* On Microsoft Azure, create a file `/etc/hostname.hvn0`
* On Amazon AWS, create a file `/etc/hostname.xnf0`
* On Exoscale, create a file `/etc/hostname.vio0`
2017-06-29 10:08:38 +00:00
* On OpenBSD VMM (with meta-data), create a file `/etc/hostname.vio0`
* On OpenStack/VMware, create a file `/etc/hostname.vmx0`
* On OpenNebula, create a file `/etc/hostname.if`
where _if_ is the name of your primary interface.
2017-06-29 12:53:58 +00:00
* The content of the file is identical for all of them:
2017-06-29 10:08:38 +00:00
dhcp
!/usr/local/libexec/cloud-agent "\$if"
Author
------
[Reyk Floeter](https://github.com/reyk/).
2017-06-29 10:11:07 +00:00
See the [License](LICENSE.md) file for more information.