Criando uma Instância

No Private Cloud Appliance, você pode criar uma instância usando a UI da Web do Compute, a CLI do OCI e a API.

Antes de Começar

Consulte Tutorial: Iniciando sua Primeira Instância para obter informações sobre a entrada necessária para criar uma instância.

A lista a seguir descreve as informações mínimas que você deve fornecer para criar uma instância:

Um nome para a instância
O compartimento no qual você deseja criar a instância
Uma imagem ou volume de inicialização
Uma forma – Se você estiver usando uma imagem de plataforma, especifique o VM.PCAStandard.E5. Forma flexível para cargas de trabalho e aplicativos genéricos. Para cargas de trabalho aceleradas por GPU, selecione uma forma de GPU dedicada. Para obter descrições de formas disponíveis, consulte Formas de Computação.
Uma sub-rede
Uma chave SSH pública

Para fazer log-in na instância, os usuários precisam de uma chave SSH ou de uma senha, dependendo de como a imagem foi criada. Se a instância exigir chaves SSH para autenticação, você deverá fornecer a chave pública ao criar a instância. Não é possível fornecer a chave SSH pública após a criação da instância.

Para criar uma instância usando a CLI do OCI, você precisa das mesmas informações listadas anteriormente para a UI da Web do serviço Compute, exceto pelo fato de não precisar de um nome de instância. Se você não fornecer um nome para a instância, o nome padrão será instanceYYYYMMDDhhmmss, em que YYYYMMDDhhmmss é a data e a hora de criação.

Para modificar as opções de inicialização, use a CLI do OCI. Não é possível alterar as opções de inicialização ou as VPUs de volume de inicialização por GB após a criação da instância.

As opções de metadados da instância permitem que você anexe informações importantes a instâncias como uma chave SSH, informações para uso do cloud-init e labels e proxies para nós em um pool de nós de cluster do Kubernetes Engine. Há restrições de chave de metadados. Consulte Restrições de Chave de Metadados. Para configurar metadados, crie a instância usando a opção --metadata ou --extended-metadata da CLI do OCI.

Uma maneira alternativa de criar uma instância é criar uma configuração de instância e usar essa configuração para iniciar uma instância, conforme descrito em Como Trabalhar com Configurações de Instância. Ao usar uma configuração de instância para criar uma instância, você pode especificar blockVolumes e secondaryVnics, conforme mostrado no procedimento da CLI do OCI em Criando uma Configuração de Instância com a Entrada de Valores de Configuração.

Depois de criar uma instância, você pode opcionalmente anexar VNICs adicionais e designar endereços IP privados e públicos. Consulte Criando e Anexando uma VNIC Secundária, Gerenciando Endereços IP Privados e Gerenciando Endereços IP Públicos.

Observação

Se você especificar um tamanho de volume de inicialização maior que o padrão, será necessário aumentar o volume para aproveitar o tamanho maior. Consulte Redimensionando Volumes.

Evite inserir informações confidenciais em nomes e tags.

1. Crie ou obtenha os seguintes recursos e informações:
  
  Uma imagem ou volume de inicialização e o compartimento no qual a imagem ou o volume de inicialização está localizado. Consulte Listando Imagens e Exibindo Detalhes e Listando Volumes de Inicialização.
  
  Uma rede virtual na nuvem (VCN) e uma sub-rede e o compartimento no qual a VCN e a sub-rede estão localizadas. Consulte Creating a VCN.
  
  Uma chave SSH (Secure Shell) pública se os usuários estabelecerem conexão com a instância usando SSH
2. No Painel de Controle da UI do Compute, execute um dos seguintes procedimentos para abrir a caixa de diálogo Criar Instância:
  
  Selecione Criar Instância no canto superior esquerdo.
  
  No bloco Compute, selecione Instâncias. Na parte superior da lista de instâncias no lado direito, selecione Criar Instância.
  
  No bloco Compute, selecione Imagens Personalizadas. Para a imagem que você deseja usar para criar a instância, selecione o menu Ações () e, em seguida, selecione Criar Instância com Base na Imagem. Talvez você precise alterar o compartimento na parte superior da lista de imagens para ver a imagem desejada.
  
  Quando você usa a opção Criar Instância com Base na Imagem, o nome da imagem já é informado na caixa de diálogo Criar Instância e você não pode alterá-lo. Não é necessário inserir nenhuma das informações descritas em "Imagem de Origem" na etapa a seguir.
3. Na caixa Criar Instância, especifique as seguintes informações:
  
  Nome: Informe um nome para a instância. Os nomes de instâncias têm as seguintes características:
  
  Pode ser alterado após a criação da instância.
  
  Não precisa ser exclusivo.
  
  Pode conter somente caracteres alfanuméricos e o caractere hífen (-).
  
  Pode ter no máximo 63 caracteres.
  
  Criar no Compartimento: Selecione o compartimento no qual você deseja criar a instância.
  
  Domínio de Falha: (Opcional) Selecione uma domínio de falha. Por padrão, o sistema seleciona automaticamente o melhor domínio de falha para a instância quando a instância é criada. Se você especificar um domínio de falha e o domínio de falha solicitado não puder acomodar a instância, a inicialização da instância falhará. O domínio de falha pode ser alterado após a criação da instância.
  
  Imagem de Origem: Selecione uma imagem ou um volume de inicialização.
  
  Selecione o Tipo de Origem: Imagem da Plataforma, Imagem Personalizada ou Volume de Inicialização.
  
  Se você tiver selecionado Imagem Personalizada ou Volume de Inicialização, selecione o compartimento no qual a imagem ou o volume de inicialização que você deseja usar está localizado.
  
  Selecione uma imagem ou volume de inicialização na lista.
  
  Se você tiver selecionado Imagem da Plataforma, verá uma lista tabular com as colunas Sistema Operacional, Versão do Sistema Operacional e Criação de Imagem (a data em que a imagem foi criada). Você pode usar a seta do menu drop-down à direita da Versão do SO para selecionar uma versão diferente. Por exemplo, para o sistema operacional Oracle Linux, você pode usar o menu suspenso para selecionar 9, 8 ou 7.9.
  
  Se você tiver selecionado Imagem Personalizada, verá uma lista tabular com as colunas Nome, Sistema Operacional e Versão do Sistema Operacional. Você pode usar as setas nos cabeçalhos de coluna para classificar a lista. Você pode filtrar a lista usando o menu drop-down Sistema Operacional acima da lista de imagens.
  
  Se você tiver selecionado Volume de Inicialização, verá uma lista tabular com as colunas Nome, Tamanho (GB) e Criado (a data em que o volume de inicialização foi criado). Você pode usar as setas nos cabeçalhos de coluna para classificar a lista. Na seção Volume de Inicialização (após a seção Forma), você pode personalizar o tamanho do volume de inicialização.
  
  Se a lista for muito longa para caber em uma exibição, use a seta para exibir outra página da lista.
  
  Para usar uma imagem de plataforma que estava disponível anteriormente, mas não está mais listada, use a CLI do OCI para criar a instância e especificar o OCID da imagem.
  
  A imagem de origem não pode ser alterada após a criação da instância.
  
  Forma: Se você estiver usando uma imagem de plataforma, selecione a forma apropriada para o uso pretendido:
  
  Cargas de trabalho e aplicativos genéricos: Selecione uma forma flexível e configure o número de OCPUs e memória.
  
  Para os valores de OCPU e memória, selecione dentro de cada campo de valor para ver os valores mínimo e máximo permitidos. A configuração de OCPU e memória pode ser alterada após a criação da instância.
  
  Se o sistema incluir uma expansão de GPU opcional e você planejar usar a instância para cargas de trabalho aceleradas por GPU, selecione uma forma de GPU dedicada. Você pode selecionar de 1 a 4 GPUs e a instância recebe 27 OCPUs e 200 GB de memória por GPU.
  
  Para obter uma descrição das formas suportadas, consulte Formas de Computação.
  
  Volume de Inicialização: (Opcional) Marque a caixa para especificar um tamanho de volume de inicialização personalizado ou uma definição de desempenho de volume.
  
  Tamanho do volume de inicialização (GB): O tamanho do volume de inicialização padrão para a imagem selecionada é mostrado. Para especificar um tamanho maior, informe um número inteiro de gigabytes até 16384 GB (16 TB) ou use as setas de incremento e diminuição. Não é possível informar um valor menor que o padrão.
  
  Se você especificar um tamanho de volume personalizado de inicialização, será necessário aumentar o número de partições a fim de aproveitar o tamanho maior. As imagens da plataforma Oracle Linux incluem o pacote oci-utils. Use o comando oci-growfs desse pacote para estender a partição raiz e, em seguida, aumentar o sistema de arquivos. Para outros sistemas operacionais ou para imagens personalizadas, siga as instruções desse sistema operacional.
  
  Desempenho do volume de inicialização (VPUs): Use as setas de incremento e redução para alternar entre desempenho balanceado (10 VPUs/GB) e alto desempenho (20 VPUs/GB). Para obter mais informações, consulte Opções de Desempenho do Serviço Block Volume.
  
  Se você especificar a opção de alto desempenho e existir um pool de alto desempenho, mas a imagem especificada não existir no pool de alto desempenho (o pool de alto desempenho foi criado após a importação da imagem), a imagem especificada será copiada do pool de capacidade para o pool de alto desempenho. Essa operação pode levar de 20 a 30 minutos, dependendo do tamanho da imagem, da configuração da rede e da carga.
  
  Esta operação de cópia é uma operação única para cada imagem. Solicitações futuras para criar uma instância que especifique esta imagem e o pool de alto desempenho não incorrerão neste atraso de cópia de imagem.
  
  Você receberá uma mensagem de erro da cópia da imagem se a imagem for maior que 200 gigabytes. As imagens de plataforma não são maiores que 200 gigabytes.
  
  Sub-rede: Selecione uma sub-rede.
  
  Selecione uma VCN na lista. Talvez você precise alterar o compartimento para o compartimento no qual a VCN está localizada.
  
  Selecione uma sub-rede.
  
  Endereço IP Público: para estabelecer conexão com a instância usando SSH, marque a caixa Designar IP Público para ter um endereço IP público designado à instância. Essa caixa será marcada por padrão se você especificar uma sub-rede pública. Se você não marcar essa caixa ou se desmarcar essa caixa e quiser designar um endereço IP público posteriormente, consulte Designando um Endereço IP Público Efêmero a uma Instância para obter instruções.
  
  Endereço IP Privado: (Opcional) Especifique um endereço IP privado disponível no CIDR da sub-rede. Por padrão, um endereço IP privado é atribuído automaticamente.
  
  Nome do Host: (Opcional) Informe um nome de host se você estiver usando DNS na rede na nuvem. O nome do host deve ser exclusivo em todas as VNICs da sub-rede.
  
  Por padrão, o nome da instância é usado para o nome do host. O nome do host também pode ser configurado no SO após a criação da instância.
  
  Se esta for uma instância do UNIX, consulte Criando um Ponto de Acesso NFS e Montando Sistemas de Arquivos em Instâncias baseadas no UNIX para obter mais informações sobre como definir o nome do host corretamente para montar sistemas de arquivos.
  
  Chaves SSH: Para estabelecer conexão com a instância usando SSH, forneça uma chave SSH pública.
  
  Observação
  
  Não é possível fornecer esta chave SSH após a criação da instância.
  
  Script de Inicialização: (Opcional) Forneça um script de inicialização. Este é um arquivo de dados a ser usado para inicialização de instância personalizada.
  
  Grupo de Segurança de Rede: (Opcional) Por padrão, a nova instância não é anexada a nenhum NSG. Marque a caixa de seleção Ativar Grupo de Segurança de Rede para adicionar a VNIC principal desta instância a um ou mais NSGs.
  
  Selecione um NSG na lista drop-down. Você pode precisar alterar o compartimento para encontrar o NSG que deseja.
  
  Selecione Add Another NSG se quiser anexar a outro NSG.
  
  Para remover um NSG da lista, selecione a lixeira à direita desse NSG. Para remover o último NSG ou todos os NSGs, desmarque a caixa Ativar Grupos de Segurança de Rede.
  
  Para atualizar anexos do NSG para esta instância posteriormente, consulte Atualizando uma VNIC.
  
  Consulte Controlando o Tráfego com Grupos de Segurança de Rede para obter informações sobre NSGs.
  
  Opções de Instância: Marque a caixa para desativar Pontos Finais do Serviço de Metadados da Instância Legada. Por padrão, as rotas do IMDS (Instance Metadata Service) legado (/v1) são ativadas. Se você tiver feito upgrade de seus aplicativos para usar pontos finais /v2, marque esta caixa para desativar pontos finais /v1. Para obter mais informações sobre o Serviço de Metadados da Instância, consulte Recuperando Metadados da Instância de Dentro da Instância. Para obter mais informações sobre como fazer upgrade de seus aplicativos, consulte Upgrade para Pontos Finais do IMDS Versão 2.
  
  Configuração de disponibilidade: (Opcional) Especifique como tratar essa instância durante a manutenção do nó de computação"
  
  Permitir que o Private Cloud Appliance escolha a melhor opção de migração
  
  Essa opção é selecionada por padrão para permitir que o sistema escolha a melhor opção para tratar essa instância durante a manutenção do nó de computação. A melhor opção geralmente é a migração ao vivo para um nó de computação íntegro. Você não pode alterar esta configuração. Se essa instância não deve ser migrada ao vivo, por exemplo, não há suporte para a migração ao vivo em instâncias de um cluster do Microsoft Windows, defina a tag de formato livre PCA_no_lm como Verdadeira para impedir a migração ao vivo para essa instância.
  
  Restaurar o estado do ciclo de vida da instância após a manutenção da infraestrutura
  
  Esta opção é selecionada por padrão para especificar que as instâncias em execução devem ser reiniciadas automaticamente após uma operação de manutenção, como migração ao vivo. Se essa caixa não estiver marcada, a instância será recuperada no estado interrompido.
  
  Tagging: (Opcional) Adicione tags definidas ou de formato livre para esse recurso, conforme descrito em Adicionando Tags na Criação de Recursos. As tags também podem ser aplicadas posteriormente.
4. Selecione Criar Instância.
  
  Com êxito, a página de detalhes da instância é exibida. Na guia Configuração, a coluna Configuração da Forma mostra a forma, o número de OCPUs, a largura de banda da rede e a memória total. Na guia Rede, a coluna VNIC mostra a VCN e a sub-rede, e a coluna Acesso à Instância mostra o endereço IP privado principal e qualquer endereço IP público designado.
  
  Para verificar o status da inicialização da instância, role até a seção Resources e selecione Work Request(s).
  
  Se a inicialização da instância falhar por causa de restrições de recursos, tente soluções como as seguintes:
  
  Especifique outro domínio de falha ou não especifique nenhum domínio de falha e permita que o sistema o escolha.
  
  Especifique uma forma que consuma menos recursos.
  
  Interrompa uma instância da qual você não precisa mais.
  
  Encerre uma instância que você não precisa mais.
  
  Se o status da solicitação de serviço for Falha e nenhum motivo for listado para a falha, a causa da falha pode ser temporária. Aguarde um pouco e repita a criação da instância.
Use o comando oci compute instance launch e os parâmetros necessários para criar uma instância.
oci compute instance launch --availability-domain availability_domain --compartment-id compartment_OCID --shape shape --subnet-id subnet_OCID --source-details file://image_info.json [OPTIONS]
Para obter uma lista completa de parâmetros obrigatórios e opcionais, use o seguinte comando:
```
oci compute instance launch -h
```
Para obter uma lista completa de comandos, flags e opções da CLI, consulte a Referência da Linha de Comandos.
Procedimento

Crie ou obtenha os seguintes recursos e informações:

O nome do domínio de disponibilidade que você deseja usar: oci iam availability-domain list

O OCID do compartimento no qual você deseja criar a instância: oci iam compartment list

O nome da forma desta instância. Selecione a forma apropriada para o uso pretendido:

Cargas de trabalho e aplicativos genéricos:

VM.PCAStandard.E5.Flex

Você também deve especificar a configuração da forma, conforme mostrado no exemplo a seguir. É necessário fornecer um valor para ocpus. A propriedade memoryInGBs é opcional; o valor padrão em GBs é 16 vezes o número de ocpus.

--shape-config '{"ocpus": 32, "memoryInGBs": 512}'

Cargas de trabalho aceleradas por GPU:

VM.GPU.L40S.1 | VM.GPU.L40S.2 | VM.GPU.L40S.4

As formas de GPU não são flexíveis. Não há parâmetros de configuração personalizados.

Consulte Formas de Computação.

A configuração da forma pode ser alterada após a criação da instância.

O OCID da sub-rede na qual a VNIC anexada a essa instância será criada: oci compute vnic-attachment list

Se você fornecer um valor para a opção --hostname-label, consulte a descrição do Nome do Host na guia Console.

Reúna um dos valores a seguir para especificar a origem da imagem – seja uma imagem ou um volume de inicialização.

O OCID da imagem usada para inicializar a instância:
oci compute image list

Observação

Não selecione uma imagem que tenha "-OKE-" em seu nome para exibição. As imagens "-OKE-" só podem ser usadas no Mecanismo withKubernetes (OKE).

O OCID do volume de inicialização usado para inicializar a instância:
oci compute boot-volume-attachment list

Uma chave SSH (Secure Shell) pública para estabelecer conexão com a instância usando SSH.

Observação

Não é possível fornecer esta chave SSH após a criação da instância.

Para obter uma lista completa de parâmetros obrigatórios e opcionais, use o seguinte comando:

$ oci compute instance launch -h

Para obter informações sobre os valores --display-name e --hostname-label, consulte as descrições na guia Console desta página.

Construa um argumento para a opção --source-details.

O argumento --source-details pode ser um arquivo JSON ou uma string de linha de comando. Use o seguinte comando para mostrar o formato correto das propriedades e dos valores JSON:

oci compute instance launch --generate-param-json-input source-details

Para obter informações sobre o bootVolumeSizeInGBs, consulte "Tamanho do volume de inicialização" na guia Console.

Para obter informações sobre o bootVolumeVpusPerGB, consulte "Alto Desempenho" na guia Console.

Observação

Quando você list ou get posteriormente esta instância, o valor de bootVolumeVpusPerGB será null porque essa propriedade de volume de inicialização não será armazenada no objeto de instância após a criação da instância. Para verificar o valor após a inicialização da instância, use o comando bv boot-volume list ou get e verifique o valor de vpus-per-gb.

(Opcional) Crie um argumento para a opção --launch-options.

Somente a propriedade firmware pode ser alterada. O valor padrão é BIOS. Como alternativa, você pode especificar UEFI_64. Se você não fornecer um valor correto para firmware, a instância poderá não ser iniciada. Não é possível atualizar o valor da propriedade firmware com o comando instance update.

Veja a seguir os valores padrão:

{ "bootVolumeType": "PARAVIRTUALIZED", "firmware": "BIOS", "isConsistentVolumeNamingEnabled": false, "is-pv-encryption-in-transit-enabled": false, "networkType": "PARAVIRTUALIZED", "remoteDataVolumeType": "PARAVIRTUALIZED" }

Para alterar o valor da propriedade firmware, especifique a seguinte opção:

--launch-options file://launch_options.json

Quando o seguinte for o conteúdo do arquivo launch_options.json:

{ "bootVolumeType": "PARAVIRTUALIZED", "firmware": "UEFI_64", "isConsistentVolumeNamingEnabled": false, "is-pv-encryption-in-transit-enabled": false, "networkType": "PARAVIRTUALIZED", "remoteDataVolumeType": "PARAVIRTUALIZED" }

(Opcional) Construa um argumento para a opção --metadata ou --extended-metadata.

Os dados personalizados do usuário podem ser anexados à instância usando as opções --metadata e --extended-metadata. Os pares de chave/valor de metadados são mapas de string/string no formato JSON. Os metadados estendidos podem ser objetos JSON aninhados. Os metadados estendidos podem ser objetos JSON aninhados.

O tamanho combinado dos metadados e dos metadados estendidos pode ter no máximo 32.000 bytes.

As chaves SSH podem ser fornecidas alternativamente no argumento de arquivo da opção --ssh-authorized-keys-file. Os dados do usuário podem ser fornecidos alternativamente no argumento de arquivo da opção --user-data-file. Use a opção -h para obter mais informações.

No exemplo da próxima etapa, o arquivo de chaves autorizadas contém uma ou mais chaves SSH públicas no formato exigido pelo arquivo authorized_keys do SSH. Use um caractere de nova linha para separar várias chaves. As chaves públicas SSH podem ser fornecidas como o valor da chave ssh_authorized_keys na opção --metadata ou no argumento de arquivo da opção --ssh-authorized-keys-file. Use -h para obter mais informações.

Execute o comando de inicialização da instância.

Sintaxe:

oci compute instance launch --availability-domain availability_domain_name \ --compartment-id compartment_OCID --shape shape --subnet-id subnet_OCID \ --source-details file://image_info.json

Exemplo:

Se você estiver usando uma sub-rede pública, um endereço IP público será designado por padrão ou você poderá definir o valor da opção --assign-public-ip como true. Se você precisar designar um endereço IP público posteriormente, consulte Designando um Endereço IP Público Efêmero a uma Instância para obter instruções.

Se você tiver feito upgrade de seus aplicativos para usar pontos finais do Serviço de Metadados da Instância (IMDS) /v2, use a opção --instance-options para definir areLegacyImdsEndpointsDisabled como true. Por padrão, as rotas do Serviço de Metadados da Instância legada (/v1) são ativadas. Para obter mais informações sobre o Serviço de Metadados da Instância, consulte Recuperando Metadados da Instância de Dentro da Instância.

$ oci compute instance launch --availability-domain AD-1 --compartment-id <compartment_OCID> --display-name ops1 --shape VM.PCAStandard.E5.Flex --subnet-id <subnet_OCID> --source-details '{"bootVolumeSizeInGBs":100,"bootVolumeVpusPerGB":20,"imageId":"<image_OCID>","sourceType":"image"}' --assign-public-ip true --ssh-authorized-keys-file ./.ssh/<ssh_key_file> --instance-options '{"areLegacyImdsEndpointsDisabled": true}' { "data": { "agent-config": null, "availability-config": { "is-live-migration-preferred": null, "recovery-action": "RESTORE_INSTANCE" }, "availability-domain": "AD-1", "capacity-reservation-id": null, "compartment-id": "ocid1.compartment.unique_ID", "dedicated-vm-host-id": null, "defined-tags": {}, "display-name": "ops1", "extended-metadata": null, "fault-domain": "FAULT-DOMAIN-1", "freeform-tags": {}, "id": "ocid1.instance.unique_ID", "image-id": "ocid1.image.unique_ID", "instance-options": { "are-legacy-imds-endpoints-disabled": true }, "ipxe-script": null, "launch-mode": "PARAVIRTUALIZED", "launch-options": { "boot-volume-type": "PARAVIRTUALIZED", "firmware": "BIOS", "is-consistent-volume-naming-enabled": false, "is-pv-encryption-in-transit-enabled": false, "network-type": "PARAVIRTUALIZED", "remote-data-volume-type": "PARAVIRTUALIZED" }, "lifecycle-state": "PROVISIONING", "metadata": { "ssh_authorized_keys": <public_ssh_key>" }, "platform-config": null, "preemptible-instance-config": null, "region": "region_name", "shape": "VM.PCAStandard.E5.Flex", "shape-config": { "baseline-ocpu-utilization": null, "gpu-description": null, "gpus": null, "local-disk-description": null, "local-disks": null, "local-disks-total-size-in-gbs": null, "max-vnic-attachments": 16, "memory-in-gbs": 256.0, "networking-bandwidth-in-gbps": 24.6, "ocpus": 16.0, "processor-description": null }, "source-details": { "boot-volume-size-in-gbs": 100, "bootVolumeVpusPerGB": 20, "image-id": "ocid1.image.unique_ID", "kms-key-id": null, "source-type": "image" }, "system-tags": null, "time-created": "2021-09-22T20:20:04.715304+00:00", "time-maintenance-reboot-due": null }, "etag": "92180faa-3660-446c-9559-c12a6e6111f9", "opc-work-request-id": "ocid1.workrequest.unique_ID" }

Use o comando work-requests work-request get para monitorar o status da inicialização da instância:

$ oci work-requests work-request get --work-request-id ocid1.workrequest.unique_ID

Se o status da solicitação de serviço for Falha e nenhum motivo for fornecido para a falha, a causa da falha poderá ser temporária. Se nenhum motivo for fornecido para a falha, aguarde um pouco e tente criar a instância novamente.
Use a operação LaunchInstance para criar uma instância.

Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.

Documentação do Oracle Cloud Infrastructure

Criando uma Instância