このドキュメントでは、Google Distributed Cloud(GDC)エアギャップのインスタンスに永続仮想マシン(VM)ディスクをアタッチする手順について説明します。
特定のワークロード要件を満たすように、非ブートディスクを VM にアタッチします。ストレージを VM インスタンスから切り離すことで、VM のライフサイクルとは無関係に重要なデータを保持しながら、ワークロードの需要に合わせてパフォーマンスと容量を自動スケーリングできます。
このドキュメントは、Distributed Cloud 環境で VM ディスクを追加して構成するプラットフォーム管理者またはアプリケーション オペレーター グループのデベロッパーを対象としています。詳細については、GDC エアギャップ ドキュメントの対象読者をご覧ください。
始める前に
gdcloud コマンドライン インターフェース(CLI)コマンドを使用するには、gdcloud CLI をダウンロード、インストール、構成していることを確認してください。Distributed Cloud のすべてのコマンドは gdcloud または kubectl CLI を使用し、オペレーティング システム(OS)環境を必要とします。
kubeconfig ファイルのパスを取得する
Management API サーバーに対してコマンドを実行するには、次のリソースが必要です。
Management API サーバーの kubeconfig ファイルがない場合は、ログインして生成します。
これらの手順では、
MANAGEMENT_API_SERVERを Management API サーバーの kubeconfig ファイルのパスに置き換えます。
IAM ロールをリクエストする
IAM プロジェクト管理者に連絡して、プロジェクトに対する次のロールをリクエストしてください。
仮想マシン プロジェクト管理者(
project-vm-admin): プロジェクトの名前空間で VM を作成、変更、一覧表示、削除します。プロジェクト閲覧者(
project-viewer): プロジェクトの名前空間内のすべてのリソースを表示します。
すべての VM ロールは、VM が存在するプロジェクトの Namespace にバインドする必要があります。手順に沿ってアクセス権を確認します。
ディスクを VM にアタッチする
非ブートディスクを作成して VM にアタッチします。追加ディスクごとに、カスタム イメージまたは空のディスクを指定できます。VM に複数のディスクを一度に追加できます。
コンソール
ナビゲーション メニューで、[Virtual Machines] > [インスタンス] をクリックします。
VM のリストで、VM 名をクリックして詳細を表示します。
[新しいディスクを追加] をクリックします。
確認ダイアログで [停止] をクリックして VM を停止します。
VM が停止するまで数分待ちます。
[更新] をクリックします。
VM が停止状態になったら、[新しいディスクを追加] をもう一度クリックします。
[ディスクを追加] ダイアログで、新しいディスクまたは既存のディスクを選択します。
新しいディスクをプロビジョニングするには、[新しいディスク] タブをクリックします。
- [ディスク名] フィールドに、プロジェクトに固有の新しいディスク名を入力します。
- [サイズ] フィールドに、10 ~ 65, 536 GiB のディスクサイズを入力します。たとえば、10 GiB。
- [削除ルール] セクションで、[ディスクを維持] または [ディスクを削除] をクリックします。
既存のディスクを選択するには、[既存のディスク] タブをクリックします。
- [ディスク] リストで、ディスクを選択します。
- [削除ルール] セクションで、[ディスクを維持] または [ディスクを削除] をクリックします。
[保存] をクリックします。ディスクが VM のディスクのリストに表示されます。
API
VirtualMachineDiskを作成します。kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ apply -f - <<EOF apiVersion: virtualmachine.gdc.goog/v1 kind: VirtualMachineDisk metadata: name: NON_BOOT_BLANK_DISK spec: size: NON_BOOT_BLANK_DISK_SIZE EOF既存の
VirtualMachinespec.disksにVirtualMachineDiskを追加します。kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEテキスト エディタで次の項目を編集します。
# … disks: - virtualMachineDiskRef: name: VM_BOOT_DISK_NAME boot: true - virtualMachineDiskRef: name: NON_BOOT_BLANK_DISK autoDelete: false # …次の定義を使用して、変数を置き換えます。
変数 定義 MANAGEMENT_API_SERVERManagement API サーバーの kubeconfig ファイル。 PROJECTVM を作成する Google Distributed Cloud エアギャップ(GDC)プロジェクト。 VM_NAME新しい VM の名前。 VM_BOOT_DISK_NAME新しい VM ブートディスクの名前。 NON_BOOT_BLANK_DISK追加ディスクの名前。 NON_BOOT_BLANK_DISK_SIZE追加ディスクのサイズ( 20Gなど)。
非ブートディスクをフォーマットしてマウントする
ディスクを VM にアタッチしたら、次の手順に沿って VM 内からアクセスできるようにします。
VM に接続する
ディスクをフォーマットする
インスタンスにアタッチされているディスクをシリアル番号で一覧表示し、フォーマットしてマウントするディスクを探します。
ls -l /dev/disk/by-id/次の出力例では、ディスク名がシリアル番号として表示されています。
total 0 lrwxrwxrwx 1 root root 9 Sep 13 23:51 ata-QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-0ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15 lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-1ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-SATA_QEMU_HARDDISK_agentSADisk -> ../../sdc lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14 lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15 lrwxrwxrwx 1 root root 9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb各行の矢印
->の後に続く情報は、ディスク デバイス名を示します。たとえば、scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdbでは、シリアル番号はscsi-SQEMU_QEMU_HARDDISK_vm-disk-data、デバイス名はsdbです。このリストからディスクのシリアル番号を特定します。
シリアル番号リストに影響する可能性のある、状況に応じた重要な機能の動作:
virtualMachineDiskRef.name値が 20 文字より長い場合、最初の 20 文字のみがシリアル番号として使用されます。- 最初の 20 文字が同じディスクが 2 つある場合、最初のディスクだけにシリアル番号が割り当てられます。
ディスクをフォーマットします。
sudo mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/disk/by-id/DISK_ID
DISK_IDをフォーマットするディスクのシリアル番号に置き換えます。- この例では、
scsi-SQEMU_QEMU_HARDDISK_vm-disk-dataを指定して、パーティション テーブルを作成せずにディスク全体をフォーマットします。
ディスクのパフォーマンスを最大限に引き出すには、-E フラグで推奨フォーマット オプションを使用します。セカンダリ ディスクのルート ボリューム用に領域を確保する必要はないため、-m 0 を指定して、使用可能なディスク容量をすべて使用します。
ディスクをマウントする
新しいディスクのマウント ポイントにするディレクトリを作成します。任意のディレクトリを使用できます。次の例では、
/mnt/disks/にディレクトリを作成します。sudo mkdir -p /mnt/disks/MOUNT_DIRMOUNT_DIRは、ディスクをマウントするディレクトリに置き換えます。ディスクをインスタンスにマウントし、discard オプションを有効にします。
sudo mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR次のように置き換えます。
DISK_IDは、マウントするディスクのシリアル番号に置き換えます。MOUNT_DIRは、ディスクをマウントするディレクトリに置き換えます。
省略可: ディスクに読み取り権限と書き込み権限を構成します。次のコマンドは、すべてのユーザーにディスクへの書き込みアクセス権(
a+w)を付与します。sudo chmod a+w /mnt/disks/MOUNT_DIR省略可: VM 再起動時に自動マウントを構成する - ユニバーサル固有識別子(UUID)または起動スクリプトを使用します。
VM 再起動時に自動マウントを構成する - ディスク UUID
ディスクを /etc/fstab ファイルに追加して、VM の再起動時にディスクが自動的にマウントされるようにします。オペレーティング システム(OS)では、再起動のたびにデバイス名が変更されますが、デバイス UUID は、システム間でディスクを移動しても、常に同じボリュームを指します。したがって、VM の再起動時に自動マウントを構成するには、常にデバイスの UUID を使用します。
現在の
/etc/fstabファイルのバックアップを作成します。sudo cp /etc/fstab /etc/fstab.backupディスクの UUID を一覧表示します。
sudo blkid /dev/DEVICE_NAME出力例は、ディスクの
accc19c5-d0d6-4157-9672-37d4e1d48eb5の UUID を示しています。/dev/sdb: UUID="accc19c5-d0d6-4157-9672-37d4e1d48eb5" TYPE="ext4"DEVICE_NAMEは、自動的にマウントするディスクのデバイス名です。ディスクにパーティション テーブルを作成した場合は、マウントするパーティションをデバイス名の接尾辞として指定します。たとえば、sdbがディスク デバイス名で、パーティション 1 をマウントする場合、DEVICE_NAMEはsdb1になります。テキスト エディタで
/etc/fstabファイルを開き、UUID を含むエントリを作成します。UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2次のように置き換えます。
UUID_VALUEは、UUID を一覧表示するコマンドの出力として表示されるディスクUUIDに置き換えます。MOUNT_DIRは、ディスクをマウントしたディレクトリに置き換えます。MOUNT_OPTION: OS のMOUNT_OPTION値。起動時にディスクをマウントできない場合の OS の動作を指定します。
/etc/fstabエントリが正しいことを確認します。次のコマンドは、VM にアタッチされている既存のディスクとパーティションに対して
/etc/fstabエントリを検証します。findmnt --verify次の例は、検証が成功したことを示しています。想定される警告は無視してかまいません。
[W] your fstab has been modified, but systemd still uses the old version; use 'systemctl daemon-reload' to reload 0 parse errors, 0 errors, 1 warningエラーがある場合は、
fstabエントリが有効かどうかを確認します。よくある問題は、無効な非印刷文字がエントリに追加されている場合です。次のコマンドを実行すると、/etc/fstabファイル内のすべての特殊文字が表示されます。cat --show-nonprinting /etc/fstab有効な出力の例を次に示します。
LABEL=cloudimg-rootfs / ext4 defaults 0 1 LABEL=UEFI /boot/efi vfat umask=0077 0 1 UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2M-や^で始まる印刷不可能な文字など、予期しない文字がないことを確認します。
このディスクを切断する場合、またはこの VM のブートディスクからスナップショットを作成する場合は、/etc/fstab ファイルを編集して、このディスクのエントリを削除します。MOUNT_OPTION が nofail または nobootwait に設定されている場合でも、VM にアタッチされているデバイスとの /etc/fstab ファイルの同期を維持してください。ブートディスクのスナップショットを作成する前、またはディスクを切断する前に、これらのエントリを削除してください。
VM 再起動時に自動マウントを構成する - VM 起動スクリプト
起動スクリプトを使用して、再起動のたびにディスクをマウントすることもできます。これを行うには、ディスクをマウントするのコマンドを起動スクリプトに追加します。ディスクをマウントするスクリプトを追加する前に、ディスクをフォーマットするのコマンドを使用してディスクをフォーマットします。
起動スクリプトの Secret を作成します。
cat <<EOF >>mount-disk-script #!/bin/bash mkdir -p /mnt/disks/MOUNT_DIR mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR EOFkubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ create secret generic VM_NAME-mount-script \ --from-file=script=mount-disk-scriptrm mount-disk-script起動スクリプトを VM に追加します。
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEspec.startupScriptsを編集して、シークレット名を含めます。apiVersion: virtualmachine.gdc.goog/v1 kind: VirtualMachine metadata: name: VM_NAME namespace: PROJECT spec: # … startupScripts: - name: mount-script scriptSecretRef: name: VM_NAME-mount-script
起動スクリプトの構成の詳細については、こちらをご覧ください。