cloud-init
[更新: 2024年5月23日]
概要
cloud-init機能は、cloud-initに対応した弊社提供 パブリックアーカイブ (アーカイブ名の末尾に「(cloudimg)」が付くもの)をソースとして作成されたディスクを接続したサーバの初回電源投入時、指定した構成情報に従ってサーバの初期設定を行うことができる機能です。これにより、サーバ作成時のホスト名やパスワードの設定、sshの公開鍵の設置など、cloud-initがサポートする範囲で様々な設定を自動的に行うことができます。
注釈
ユーザデータの記述方法など、cloud-initの詳細については cloud-initの公式ドキュメント を参照ください。
Metadata
さくらのクラウドのcloud-init機能で利用可能なMetadataの一覧です。
サーバの基本情報に関するMetadata
Metadata名 |
説明 |
|---|---|
Server.ID |
インスタンスのID |
Server.Name |
名前 |
Server.Description |
説明 |
Server.Availability |
サーバが利用可能かどうか。利用可能ならavailableがセットされる。 |
Server.ServiceClass |
サーバのサービスクラス |
Server.InterfaceDriver |
インターフェースドライバ。virtioがセットされる。 |
Server.CreatedAt |
サーバの作成日 |
Server.ModifiedAt |
サーバの修正日 |
Server.Tags[] |
サーバに設定されているタグの一覧 |
Server.Icon.ID |
サーバのアイコンID |
Server.Icon.Name |
サーバのアイコン名 |
Server.Icon.URL |
サーバのアイコンのURL |
Sever.ServerPlan.ID |
サーバプランID |
Sever.ServerPlan.Name |
サーバプランの名前 |
Sever.ServerPlan.CPU |
CPU数 |
Sever.ServerPlan.MemoryMB |
メモリ（MB） |
Sever.ServerPlan.GPU |
GPU数 |
Sever.ServerPlan.Commitment |
プラン種別（通常プラン、コア占有プラン、GPUプラン） |
サーバのゾーンに関するMetadata
Metadata名 |
説明 |
|---|---|
Server.Zone.ID |
ゾーンのID |
Server.Zone.Name |
ゾーン名 |
Server.Zone.Description |
ゾーンの説明 |
Server.Zone.DisplayOrder |
ゾーンの表示順 |
Server.Zone.VNCProxy.IPAddress |
VNCProxyのIP |
Server.Zone.VNCProxy.HostName |
VNCProxyのホスト名 |
Server.Zone.FTPServer.IPAddress |
FTPServerのIP |
Server.Zone.FTPServer.HostName |
FTPServerのホスト名 |
Server.Zone.Region.ID |
リージョンID |
Server.Zone.Region.Name |
リージョン名 |
Server.Zone.Region.Description |
リージョンの説明 |
Server.Zone.Region.NameServers[] |
リージョンのネームサーバ |
サーバに接続されているディスクに関するMetadata
Metadata名 |
説明 |
|---|---|
Server.Disks[].ID |
ディスクのID |
Server.Disks[].Name |
ディスクの名前 |
Server.Disks[].Connection |
ディスクの接続ドライバ。virtioがセットされる。 |
Server.Disks[].ConnectionOrder |
ディスクの接続順序 |
Server.Disks[].ReinstallCount |
ディスクに再インストールを行った回数 |
Server.Disks[].Availability |
ディスクが利用可能かどうか。availableの文字列がセットされている場合が利用可能状態。 |
Server.Disks[].SizeMB |
ディスクのサイズ（MB） |
Server.Disks[].Plan.ID |
ディスクのプランID |
Server.Disks[].BundleInfo |
ディスクのバンドル情報 |
Server.Disks[].Storage.ID |
ストレージID |
Server.Disks[].Storage.Class |
ストレージのクラス。iscsi1204がセットされる。 |
サーバのネットワークインターフェース（NIC）に関するMetadata
Metadata名 |
説明 |
|---|---|
Server.Interfaces[].ID |
インターフェースのID |
Server.Interfaces[].MACAddress |
インターフェースのMACアドレス |
Server.Interfaces[].IPAddress |
インターフェースのIPアドレス |
Server.Interfaces[].UserIPAddress |
インターフェースのユーザIPアドレス |
Server.Interfaces[].HostName |
インターフェースのホスト名 |
Server.Interfaces[].Switch.ID |
インターフェースが接続されているスイッチのID |
Server.Interfaces[].Switch.Name |
インターフェースが接続されているスイッチのの名前 |
Server.Interfaces[].Switch.Scope |
インターフェースが接続されているスイッチのスコープ。sharedで共有セグメントに接続されていることを表す。 |
Server.Interfaces[].Switch.Subnet.NetworkAddress |
インターフェースが接続されているスイッチのサブネットネットワークアドレス |
Server.Interfaces[].Switch.Subnet.NetworkMaskLen |
インターフェースが接続されているスイッチのサブネットマスク長 |
Server.Interfaces[].Switch.Subnet.DefaultRoute |
インターフェースが接続されているスイッチのサブネットのデフォルトルート |
Server.Interfaces[].Switch.Subnet.Internet.BandWidthMbps |
インターフェースが接続されているネットワークの帯域幅（Mbps） |
Server.Interfaces[].PacketFilter |
インターフェースに設定されているパケットフィルターの情報 |
cloud-initの利用方法
サーバの新規作成時
サーバの新規作成時、ディスクのソースとしてcloud-init対応パブリックアーカイブを指定するとcloud-init設定用フォームが表示され、入力内容に従った設定でサーバを起動することができます。
注意
サーバ新規作成時にcloud-init設定フォームに指定した内容が有効になるのは「作成後すぐに起動」のチェックを有効にした場合のみです。サーバ作成と起動を同時に行わない場合は「cloud-init起動」による電源操作、またはAPIでのユーザ設定・起動をご利用ください。
サーバ作成の画面に移動（サーバの作成の詳細については、 こちらのページ をご参照ください。）
サーバ作成画面の「ディスク > アーカイブ選択」からcloudimgのアーカイブを選択
「cloud-init設定」からサーバの基本設定を入力
公開鍵、ホスト名、タイムゾーン、ロケールを入力します。
公開鍵は、クラウドアカウントに登録されたもの、もしくはGitHubアカウントに登録されたものを利用することもできます。
注意
cloud-initアーカイブは公開鍵の設定が必須となります。パスワードは「cloud-init設定 > 追加ユーザデータ」より設定可能ですが、セキュリティの観点からパスワードの設定は非推奨です。 また、パスワードを設定される場合は、SHA512でハッシュ化したパスワードを利用するようにしてください。
「cloud-init設定 > 追加ユーザデータ」に必要に応じて追加の設定を入力
下図のように追加のユーザデータの設定をyaml形式で記述することができます。
上図の追加ユーザデータでは、起動時にインストールするパッケージの設定やキーボードの設定などを行い、これら全ての処理が終了した後サーバの再起動が実施されます。 このように追加ユーザデータにcloud-initのモジュールを記述いただくことで、サーバの初期設定をカスタマイズすることができます。 cloud-initのモジュールの詳細については、 cloud-init公式ページのModules をご参照ください。
注意
追加ユーザデータにホスト名、タイムゾーン、ロケールを記述された場合、「cloud-init設定 > ホスト名、タイムゾーン、ロケール」に入力された内容は、追加ユーザデータで指定されたものに上書きされます。ただし、サーバを複数台同時に作成される場合に限り、「cloud-init設定 > ホスト名」から入力した内容が優先され、ホスト名フィールドに入力された内容の連番（hostname-01, hostname-02...）で設定されることにご注意ください。
サーバ作成をクリックしサーバを作成
サーバの初回起動操作時
cloud-init対応パブリックアーカイブをソースとしたディスクを接続したサーバの初回起動時は、 電源操作 メニューより「cloud-init起動」を選択することでcloud-initの設定内容に従ってサーバを起動することができます。
注意
cloud-init非対応パブリックアーカイブを使用していたり、2回目以降の起動の場合は、「cloud-init起動」を実行しても設定は反映されません。通常の「起動」操作と同様にサーバが起動されます。
実際の起動前に操作確認画面が表示されるので、ここで スタートアップスクリプト に登録済みのyaml_cloud_configクラスのスクリプトを選択、またはテキストエリアに直接記述した内容でサーバが設定されます。
APIでの設定・起動
cloud-init対応パブリックアーカイブをソースとしたディスクを接続したサーバの初回起動時は、APIでユーザデータを指定し起動することも可能です。APIの詳細に関しましては、 さくらのクラウドAPIドキュメント を参照ください。