cloud-init#

LXD は次のインスタンスまたはプロファイル設定キーを使用して cloud-init をサポートします。

cloud-init.vendor-data
cloud-init.user-data
cloud-init.network-config

詳細な情報はcloud-init インスタンスオプションとcloud-initドキュメント内のLXDデータソースを参照してください。

cloud-initを使おうとする前に、これから使おうとするイメージ・ソースをどれにするかをまず決めてください。

ubuntu と ubuntu-daily の remote にあるイメージは全て cloud-init が有効です。 images remote のイメージで cloud-init が有効なイメージがあるものは /cloud という接尾辞がつきます（例: images:ubuntu/22.04/cloud）。

vendor-data と user-data は同じルールに従いますが、以下の制約があります。

ユーザーは vendor data に対して究極のコントロールが可能です。実行を無効化したりマルチパートの入力の特定のパートの処理を無効化できます。
デフォルトでは初回ブート時のみ実行されます。
vendor data はユーザーにより無効化できます。インスタンスの実行に vendor data の使用が必須な場合は vendor data を使うべきではありません。
ユーザーが指定した cloud-config は vendor data の cloud-config の上にマージされます。

LXD のインスタンスではインスタンスの設定よりもプロファイル内の vendor-data を使うべきです。

cloud-config の例は cloud-init のドキュメントにあります。

注釈

cloud-init.user-dataとcloud-init.vendor-dataの両方が指定された場合、cloud-initは2つの設定をマージします。

しかし、両方の設定で同じキーを使った場合、マージは不可能になるかもしれません。この場合、指定されたデータをどのようにマージするべきかをclout-initに指定してください。手順はclou-initドキュメントのMerging User-Data Sectionsを参照してください。

cloud-initドキュメント内に cloud-configの例があります。

cloud-init と連携する#

安全にテストする方法としては、デフォルトプロファイルからコピーした新しいプロファイルを使います。

lxc profile copy default test

次に新しい test プロファイルを編集します。まず EDITOR 環境変数を設定しておくと良いでしょう。

lxc profile edit test

新しい LXD のインストールでは、設定ファイルは以下の例のような内容になっているはずです。

config: {}
description: Default LXD profile
devices:
  eth0:
    name: eth0
    network: lxdbr0
    type: nic
  root:
    path: /
    pool: default
    type: disk

cloud-init 設定を記述し終わったら、 lxc launch を --profile <profilename> 付きで使用してプロファイルをインスタンスに適用します。

設定に cloud-init のキーを追加する#

cloud-init キーは特殊な文法を必要とします。パイプ記号 (|) を使って、パイプの後のインデント付きのテキスト全体を cloud-init に単一の文字列として渡すことを指示します。この際改行とインデントは保持されます。これは YAML で使用されるリテラルスタイルフォーマットです。

config:
  cloud-init.user-data: |

config:
  cloud-init.vendor-data: |

config:
  cloud-init.network-config: |

カスタム user-data 設定#

cloud-init は user-data (と vendor-data) セクションをパッケージのアップグレード、パッケージのインストールや任意のコマンド実行のようなことに使用します。

cloud-init.user-data キーは最初の行でデータフォーマットのどのタイプを cloud-init に渡すのかを指示します。パッケージのアップグレードやユーザのセットアップには #cloud-config のデータフォーマットを使用します。

この結果インスタンスの rootfs には以下のファイルが作られます。

/var/lib/cloud/instance/cloud-config.txt
/var/lib/cloud/instance/user-data.txt

インスタンス作成時にパッケージをアップグレードする#

インスタンス用のレポジトリからパッケージのアップグレードをトリガーするには package_upgrade キーを使用します。

config:
  cloud-init.user-data: |
    #cloud-config
    package_upgrade: true

インスタンス作成時にパッケージをインストールする#

インスタンスをセットアップするときに特定のパッケージをインストールするには packages キーを使用しパッケージ名をリストで指定します。

config:
  cloud-init.user-data: |
    #cloud-config
    packages:
      - git
      - openssh-server

インスタンス作成時にタイムゾーンを設定する#

インスタンスのタイムゾーンを設定するには timezone キーを使用します。

config:
  cloud-init.user-data: |
    #cloud-config
    timezone: Europe/Rome

コマンドを実行する#

(マーカーファイルを書き込むなど) コマンドを実行するには runcmd キーを使用しコマンドをリストで指定します。

config:
  cloud-init.user-data: |
    #cloud-config
    runcmd:
      - [touch, /run/cloud.init.ran]

ユーザーアカウントを追加する#

ユーザーアカウントを追加するには user キーを使用します。デフォルトユーザとどのキーがサポートされるかについての詳細はドキュメントを参照してください。

config:
  cloud-init.user-data: |
    #cloud-config
    user:
      - name: documentation_example

カスタムネットワーク設定#

cloud-init は、network-config データを使い、Ubuntu リリースに応じて ifupdown もしくは netplan のどちらかを使って、システム上の関連する設定を行います。

デフォルトではインスタンスの eth0 インタフェースで DHCP クライアントを使うようになっています。

これを変更するためには設定ディクショナリ内の cloud-init.network-config キーを使ってあなた自身のネットワーク設定を定義する必要があります。その設定がデフォルトの設定をオーバーライドするでしょう（これはテンプレートがそのように構成されているためです）。

例えば、ある特定のネットワーク・インタフェースを静的 IPv4 アドレスを持ち、カスタムのネームサーバを使うようにするには、以下のようにします。

config:
  cloud-init.network-config: |
    version: 1
    config:
      - type: physical
        name: eth1
        subnets:
          - type: static
            ipv4: true
            address: 10.10.101.20
            netmask: 255.255.255.0
            gateway: 10.10.101.1
            control: auto
      - type: nameserver
        address: 10.10.10.254

この結果、インスタンスの rootfs には以下のファイルが作られます。

/var/lib/cloud/seed/nocloud-net/network-config
/etc/network/interfaces.d/50-cloud-init.cfg (ifupdown を使う場合)
/etc/netplan/50-cloud-init.yaml (netplan を使う場合)