Este documento fornece instruções para anexar um disco persistente de máquina virtual (VM) a uma instância no Google Distributed Cloud (GDC) air-gapped.
Anexe discos não de arranque à sua VM para cumprir os requisitos específicos da carga de trabalho. A separação do armazenamento da instância de VM garante que os seus dados críticos permanecem preservados independentemente do ciclo de vida da VM, ao mesmo tempo que dimensiona automaticamente o desempenho e a capacidade para corresponderem às exigências da carga de trabalho.
Este documento destina-se a programadores em grupos de administradores da plataforma ou operadores de aplicações que adicionam e configuram discos de VM num ambiente do Distributed Cloud. Para mais informações, consulte o artigo Públicos para a documentação do GDC air-gapped.
Antes de começar
Para usar os comandos da interface de linhas de comandos (CLI) gdcloud, certifique-se de que transferiu, instalou,
e configurou a CLI gdcloud.
Todos os comandos do Distributed Cloud usam a CLI gdcloud ou kubectl e requerem um ambiente de sistema operativo (SO).
Obtenha o caminho do ficheiro kubeconfig
Para executar comandos no servidor da API Management, certifique-se de que tem os seguintes recursos:
Inicie sessão e gere o ficheiro kubeconfig para o servidor da API Management, se não tiver um.
Use o caminho para o ficheiro kubeconfig do servidor da API Management para substituir
MANAGEMENT_API_SERVERnestas instruções.
Peça funções de IAM
Contacte o administrador de IAM do projeto para pedir as seguintes funções no seu projeto:
Administrador de máquinas virtuais do projeto (
project-vm-admin): crie, modifique, liste e elimine VMs no espaço de nomes do projeto.Visualizador do projeto(
project-viewer): veja todos os recursos nos espaços de nomes do projeto.
Todas as funções de VM têm de ser associadas ao espaço de nomes do projeto onde a VM reside. Siga os passos para validar o seu acesso.
Anexe um disco a uma VM
Crie e anexe discos não de arranque à sua VM. Cada disco adicional pode especificar uma imagem personalizada ou um disco em branco. Pode adicionar vários discos em simultâneo a uma VM.
Consola
No menu de navegação, clique em Máquinas virtuais > Instâncias.
Na lista de VMs, clique no nome de uma VM para ver os respetivos detalhes.
Clique em Adicionar novo disco.
Na caixa de diálogo de confirmação, clique em Parar para parar a VM.
Aguarde alguns minutos até a VM parar.
Clique em Atualizar.
Quando a VM estiver num estado parado, clique novamente em Adicionar novo disco.
Na caixa de diálogo Adicionar disco, escolha um novo disco ou um disco existente.
Para aprovisionar um novo disco, clique no separador Novo disco.
- No campo Nome do disco, introduza um novo nome de disco exclusivo do projeto.
- No campo Tamanho, introduza um tamanho de disco entre 10 e 65 536 GiB. Por exemplo, 10 GiB.
- Na secção Regra de eliminação, clique em Manter disco ou Eliminar disco.
Para escolher um disco existente, clique no separador Disco existente.
- Na lista Disco, selecione um disco.
- Na secção Regra de eliminação, clique em Manter disco ou Eliminar disco.
Clique em Guardar. O disco é apresentado na lista de discos da VM.
API
Crie um
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 EOFAdicione o
VirtualMachineDiskaoVirtualMachineexistentespec.disks:kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEEdite o seguinte no editor de texto:
# … disks: - virtualMachineDiskRef: name: VM_BOOT_DISK_NAME boot: true - virtualMachineDiskRef: name: NON_BOOT_BLANK_DISK autoDelete: false # …Substitua as variáveis com as seguintes definições.
Variável Definição MANAGEMENT_API_SERVERO ficheiro kubeconfig do servidor da API Management. PROJECTO projeto do Google Distributed Cloud air-gapped (GDC) no qual criar a VM. VM_NAMEO nome da nova VM. VM_BOOT_DISK_NAMEO nome do novo disco de arranque da VM. NON_BOOT_BLANK_DISKO nome do seu disco adicional. NON_BOOT_BLANK_DISK_SIZEO tamanho dos seus discos adicionais, como 20G.
Formate e monte um disco não de arranque
Depois de anexar um disco à VM, siga os passos necessários para o tornar acessível na VM.
Ligue-se à VM
Formate o disco
Liste os discos anexados à sua instância por número de série e localize o disco que quer formatar e montar.
ls -l /dev/disk/by-id/O exemplo de saída mostra os nomes dos discos como números de série:
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 -> ../../sdbAs informações que seguem a seta,
->, em cada linha indicam o nome do dispositivo de disco. Por exemplo, emscsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb, o número de série éscsi-SQEMU_QEMU_HARDDISK_vm-disk-datae o nome do dispositivo ésdb.Identifique o número de série do disco nesta lista.
Comportamento de funcionalidades situacionais importantes que podem afetar a lista de números de série:
- Se o valor
virtualMachineDiskRef.nametiver mais de 20 carateres, apenas os primeiros 20 carateres são usados como número de série. - Se existirem dois discos com os mesmos primeiros 20 carateres, apenas o primeiro disco tem um número de série.
- Se o valor
Formate o disco:
sudo mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/disk/by-id/DISK_ID
- Substitua
DISK_IDpelo número de série do disco que está a formatar. - Para este exemplo, especifique
scsi-SQEMU_QEMU_HARDDISK_vm-disk-datapara formatar todo o disco sem uma tabela de partições.
Para maximizar o desempenho do disco, use as opções de formatação recomendadas na sinalização -E. Uma vez que não precisa de reservar espaço para o volume raiz no disco secundário, especifique -m 0 para usar todo o espaço em disco disponível.
Monte o disco
Crie um diretório que sirva como ponto de montagem para o novo disco. Pode usar qualquer diretório. O exemplo seguinte cria um diretório em
/mnt/disks/:sudo mkdir -p /mnt/disks/MOUNT_DIRSubstitua
MOUNT_DIRpelo diretório onde quer montar o disco.Monte o disco na instância e ative a opção de descarte:
sudo mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIRSubstitua o seguinte:
DISK_IDpelo número de série do disco a montar.MOUNT_DIRpelo diretório onde quer montar o disco.
Opcional: configure as autorizações de leitura e escrita no disco. O comando seguinte concede acesso de escrita,
a+w, ao disco para todos os utilizadores.sudo chmod a+w /mnt/disks/MOUNT_DIROpcional: configure a montagem automática no reinício da VM – usando o identificador único universal (UUID) ou o script de arranque.
Configure a montagem automática no reinício da VM – UUID do disco
Adicione o disco ao ficheiro /etc/fstab para que o disco seja montado novamente de forma automática quando a VM for reiniciada. Num sistema operativo (SO), o nome do dispositivo muda a cada reinício, mas o UUID do dispositivo aponta sempre para o mesmo volume, mesmo quando move discos entre sistemas. Por conseguinte, use sempre o UUID do dispositivo para configurar a montagem automática no reinício da VM.
Crie uma cópia de segurança do ficheiro
/etc/fstabatual:sudo cp /etc/fstab /etc/fstab.backupListe o UUID do disco:
sudo blkid /dev/DEVICE_NAMEO exemplo de saída mostra o UUID
accc19c5-d0d6-4157-9672-37d4e1d48eb5para o disco/dev/sdb: UUID="accc19c5-d0d6-4157-9672-37d4e1d48eb5" TYPE="ext4"DEVICE_NAMEé o nome do dispositivo do disco que quer montar automaticamente. Se criou uma tabela de partições no disco, especifique a partição que quer montar como um sufixo para o nome do dispositivo. Por exemplo, sesdbfor o nome do dispositivo de disco e quiser montar a partição 1,DEVICE_NAMEtorna-sesdb1.Abra o ficheiro
/etc/fstabnum editor de texto e crie uma entrada que inclua o UUID:UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2Substitua o seguinte:
UUID_VALUEpeloUUIDdo disco, apresentado como a saída do List the UUID comando.MOUNT_DIRpelo diretório onde montou o disco.MOUNT_OPTIONcom o valorMOUNT_OPTIONdo seu SO, que especifica o que o SO faz se não conseguir montar o disco no momento do arranque.
Valide se as entradas
/etc/fstabestão corretas:O comando seguinte valida as entradas
/etc/fstabem relação aos discos e partições existentes anexados à VM:findmnt --verifyO exemplo seguinte mostra uma validação bem-sucedida. Pode ignorar em segurança o aviso esperado:
[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 warningSe existirem erros, verifique se as entradas
fstabsão válidas. Um problema comum ocorre quando são adicionados carateres não imprimíveis inválidos à entrada. Pode executar o comando seguinte para mostrar todos os carateres especiais no ficheiro/etc/fstab:cat --show-nonprinting /etc/fstabSegue-se um exemplo de saída válida:
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 2Certifique-se de que não existem carateres inesperados, como carateres não imprimíveis que começam com
M-ou^.
Se desanexar este disco ou criar uma captura de ecrã a partir do disco de arranque desta VM, edite o ficheiro /etc/fstab e remova a entrada deste disco. Mesmo que tenha MOUNT_OPTION definido como nofail ou nobootwait, mantenha o ficheiro /etc/fstab sincronizado com os dispositivos que se anexam à sua VM. Remova estas entradas antes de criar a captura de ecrã do disco de arranque ou desanexar o disco.
Configure a montagem automática no reinício da VM – script de arranque da VM
Também pode usar um script de arranque para montar o disco em cada reinício adicionando os comandos de Montar o disco a um script de arranque. Antes de adicionar o script para montar o disco, formate o disco com os comandos de Formatar o disco.
Crie o segredo do script de arranque.
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-scriptAdicione o script de arranque à VM.
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEEdite o
spec.startupScriptspara incluir o nome do segredo.apiVersion: virtualmachine.gdc.goog/v1 kind: VirtualMachine metadata: name: VM_NAME namespace: PROJECT spec: # … startupScripts: - name: mount-script scriptSecretRef: name: VM_NAME-mount-script
Para mais informações sobre a configuração de scripts de arranque, consulte.