Usando a CLI para Gerenciar Recursos do Compute Cloud@Customer

Atualizando sua Configuração da CLI para Acessar o Compute Cloud@Customer

Este procedimento pressupõe que você já tenha a CLI do OCI instalada e configurada para uso em sua tenancy do OCI. Estas instruções descrevem como atualizar seu ambiente CLI do OCI para executar comandos da CLI do OCI na infraestrutura do Compute Cloud@Customer.

Antes de Começar

• A CLI do OCI deve ser instalada em um sistema Linux, macOS ou Microsoft Windows que você usa para executar comandos da CLI. Se a CLI do OCI não estiver instalada, instale-a e configure-a para ser executada em sua tenancy antes de executar as etapas deste procedimento. Para obter instruções, consulte CLI (Interface de Linha de Comando).

• Você tem um arquivo de configuração do OCI configurado para executar comandos da CLI em sua tenancy. O nome do caminho do arquivo de configuração é <home>/.oci/config. Para obter mais informações, consulte Configurando o Arquivo de Configuração e Entradas do Arquivo de Configuração.

Ao final deste procedimento, as seguintes atualizações serão feitas na configuração da CLI:

• Cria um novo diretório para armazenar suas chaves de API e o arquivo ca.cert.
• Adiciona um novo arquivo de certificado ca.crt para permitir que a CLI acesse a infraestrutura.
• Copia suas chaves de API para um novo diretório.
• Cria um novo perfil da CLI no arquivo config para executar comandos da CLI na infraestrutura.
• Adiciona o novo perfil ao arquivo oci_cli_rc.

O diretório .oci terá a seguinte estrutura:

Os exemplos são para o Linux. Se você estiver usando o Microsoft Windows, use barra invertida como separador de diretório em nomes de caminho, em vez de barra.

1. Crie um novo diretório no diretório <home>/.oci para arquivos de chave de API e certificado.

   Sugestão: inclua o novo nome do perfil (será definido no arquivo config em uma etapa posterior) no nome do diretório, conforme mostrado neste exemplo:

   cd ~/.oci
   mkdir cccadmin-keys-certs

2. Copie suas chaves de API públicas e privadas para o novo diretório.

   Exemplo:

   cp oci_api_key.pem  oci_api_key_public.pem ./cccadmin-keys-certs

   Observação: O par de chaves original deve permanecer no diretório .oci para manter a autenticação da tenancy funcional.

3. Obtenha o arquivo da cadeia de autoridade de certificação (CA) da infraestrutura fornecido no pacote de certificados.

   Obtenha o pacote de certificados usando a seguinte URL:

   https://iaas.<system_name>.<domain_name>/cachain

   Em que <system_name> é o nome da infraestrutura, geralmente o mesmo que o nome para exibição. E <domain_name> é o domínio no qual a infraestrutura está.

   Salve a cadeia de CA em um arquivo com este nome de caminho: <home>/.oci/<profile_name>-keys-certs/ca.cert

4. Edite o arquivo <home>/.oci/config, copie e cole o seu perfil atual do OCI para que ele apareça duas vezes no arquivo.

   Exemplo:

   [DEFAULT]
   user=ocid1.user...unique_id
   fingerprint=xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
   key_file=/home/.oci/oci_api_key.pem
   tenancy=ocid1.tenancy...unique_ID
   region=tenancy_region
   
   [DEFAULT]
   user=ocid1.user...unique_id
   fingerprint=xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
   key_file=/home/.oci/oci_api_key.pem
   tenancy=ocid1.tenancy...unique_ID
   region=tenancy_region

5. No perfil copiado, altere estes parâmetros:

   Parâmetro	Valor
   Nome do Perfil (como [DEFAULT])	Altere isso para um nome de perfil exclusivo, por exemplo: [CCCADMIN].
   user	Sem alteração necessária.
   fingerprint	Sem alteração necessária.
   key_file	Altere o caminho para /home/.oci/<profile_name>-keys-certs
   tenancy	Sem alteração necessária.
   region	Altere a região para que ela aponte para a infraestrutura do Compute Cloud@Customer usando este formato: region=<compute-cloud-customer_system_name>.<domain_name> em que <compute-cloud-customer_system_name> é o nome da infraestrutura do Compute Cloud@Customer e <domain_name> é o domínio em que a infraestrutura está. Exemplo: region=ccc1.us.example.com

   Observação
   
   Suas informações de OCID e user tenancy fazem parte da sua configuração do serviço IAM no OCI. Se você alterar qualquer um desses parâmetros, talvez seja necessário aguardar de 10 a 15 minutos para que as alterações sejam sincronizadas na infraestrutura. Consulte Onde Gerenciar o Serviço IAM.

6. Modifique ou crie um arquivo <home>/.oci/oci_cli_rc.

   Se você não tiver um arquivo oci_cli_rc, poderá criar um com um editor de texto ou usar o comando oci-cli-rc. Consulte a página de Referência da CLI oci-cl-rc.

   Especifique os mesmos perfis no arquivo oci_cli_rc que você especificou no arquivo config.

   O exemplo a seguir mostra a adição do perfil CCCADMIN com o caminho para o novo arquivo ca.crt.

   [DEFAULT]
   cert-bundle=/home/username/.oci/ca.crt
   
   [CCCADMIN]
   cert-bundle=/home/username/.oci/cccadmin-keys-certs/ca.crt

   Observação
   
   

   O arquivo oci_cli_rc é usado para fornecer vários valores padrão da CLI do OCI e outras informações de configuração. Se você tiver outros parâmetros especificados para seu perfil de tenancy, poderá incluí-los para o novo perfil que está adicionando ao arquivo oci_cli_rc.

7. Verifique suas alterações e salve o arquivo config.

   Exemplo de arquivo config:

   [DEFAULT]
   user=ocid1.user...unique_id
   fingerprint=xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
   key_file=/home/.oci/oci_api_key.pem
   tenancy=ocid1.tenancy...unique_ID
   region=tenancy_region
   
   [CCCADMIN]
   user=ocid1.user...unique_id
   fingerprint=xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
   key_file=/home/.oci/oci_api_key.pem
   tenancy=ocid1.tenancy...unique_ID
   region=ccc1.us.example.com

   Você pode criar quantos perfis desejar. Por exemplo, se você tiver várias infraestruturas, poderá criar um perfil para cada infraestrutura.

8. Teste seu novo perfil da CLI do OCI especificando a opção --profile <profile_name> com um comando.

   Exemplo:

   oci iam user list --profile CCCADMIN

   Observação
   
   Você pode encontrar uma mensagem de advertência informando que as permissões no arquivo config ou oci_cli_rc estão muito abertas. Se isso acontecer, siga as instruções na mensagem de aviso para resolver o problema.

Executando Comandos CLI na Infraestrutura

Os argumentos da CLI necessários que você precisa usar para acessar a infraestrutura do Compute Cloud@Customer dependem de como você configurou seu ambiente da CLI. Aqui estão alguns cenários comuns:

• Se você atualizou a configuração da CLI para acessar o Compute Cloud@Customer, use a opção (--profile profile_name) na linha de comando. O perfil fornece à CLI as informações de região e certificado da infraestrutura.

  Exemplo de listagem de imagens em um compartimento em uma infraestrutura:

  oci compute image list --compartment-id ocid.compartment...uniqueID --profile CCCADMIN

• Se você não atualizou a configuração da CLI, talvez seja necessário incluir estes argumentos da CLI:

  • --region <compute-cloud-customer_system_name>.<domain_name>
  • --cert-bundle <full_path_to_CA_certificate_bundle>

  Exemplo de listagem de imagens em um compartimento em uma infraestrutura:

  oci compute image list --compartment-id ocid.compartment...uniqueID --region ccc1.us.example.com --cert-bundle <path_to_cert_file>

• Obtenha ajuda na linha de comando:

  oci --help
  
  oci network --help
  
  oci network vcn create --help

• Introdução à Interface de Linha de Comando
• Referência da Linha de Comando
• Seção de Referência da CLI do Compute Cloud@Customer