cloud-agent/README.md
Reyk Floeter d9899d488a Add initial support for OpenNebula contextualization.
Thanks to datacenterlight.ch by ungleich glarus AG for providing
access to their OpenNebula-based cloud.
2018-08-14 00:34:25 +02:00

1.2 KiB

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

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

  • 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.

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

      dhcp
      !/usr/local/libexec/cloud-agent "\$if"
    

Author

Reyk Floeter.

See the License file for more information.