Go to file
reykfloeter 14d0149cdb CMS is back! Use it in LibreSSL > 3.0.2 or with USE_LIBRESSL_CMS=1 2019-11-29 17:22:07 +00:00
agent CMS is back! Use it in LibreSSL > 3.0.2 or with USE_LIBRESSL_CMS=1 2019-11-29 17:22:07 +00:00
cms Add #if defined(LIBRESSL_VERSION_NUMBER) 2019-05-10 12:09:59 +02:00
extras Initial commit 2017-06-29 11:40:48 +02:00
CHANGELOG.md Append /etc/resolv.conf.tail if it exists 2019-11-29 17:06:39 +00:00
LICENSE.md Update copyright 2019-06-11 12:29:08 +02:00
Makefile CMS is back! Use it in LibreSSL > 3.0.2 or with USE_LIBRESSL_CMS=1 2019-11-29 17:22:07 +00:00
README.md Add Changelog, tweak README.md 2019-06-11 15:11:28 +02:00
cloud-agent.md Finalize version 0.9 2019-06-26 14:42:12 +02:00

README.md

cloud-agent for OpenBSD

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.

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

See the cloud-agent(8) documentation for more information about the usage.

Basic 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 CloudStack, such as Exoscale, create a file /etc/hostname.vio0

  • On OpenBSD VMM (with meta-data), create a file /etc/hostname.vio0

  • On OpenStack/VMware, create a file /etc/hostname.vmx0

  • The content of the file is identical for all of the above:

      dhcp
      !/usr/local/libexec/cloud-agent "\$if"
    
  • 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 for a summary of changes and download the releases from the release page.

Author

Reyk Floeter.

See the License file for more information.