Documentação do Oracle Cloud Infrastructure

Gerenciando a Tenancy do Roving Edge

Uma tenancy é um ambiente no qual os usuários criam e gerenciam recursos de nuvem para criar e configurar cargas de trabalho virtualizadas. Um ambiente Roving Edge contém uma única tenancy.

A tenancy é criada com base no Service Enclave e subsequentemente entregue ao usuário inicial na tenancy: o administrador principal da tenancy.

Criando e Atualizando uma Tenancy

Um administrador de infraestrutura configura a tenancy no Service Enclave e fornece detalhes de acesso ao administrador principal da tenancy. Em seguida, o administrador da tenancy pode começar a configurar contas de usuário adicionais e recursos de nuvem no Compute Enclave.

Usando a UI da Web de Serviço

  1. No menu de navegação, clique em Tenancies.

  2. No canto superior direito da página Tenancies, clique em Criar Tenancy.

    A janela Criar Tenancy é exibida.

  3. Preencha os detalhes da tenancy:

    • Nome: Informe um nome para a nova tenancy.

    • Description: Opcionalmente, informe uma descrição para a nova tenancy.

    • Namespace de Serviço: Defina um namespace exclusivo para todos os recursos criados nesta tenancy.

    • Credenciais de Autenticação: Defina um nome de usuário e uma senha para o administrador principal da tenancy.

      Essa conta deve ser usada para fazer log-in na tenancy pela primeira vez. O administrador da tenancy configura contas de usuários adicionais, define compartimentos, políticas e outros recursos e geralmente configura o ambiente de nuvem para que os usuários possam começar a implantar seus recursos necessários.

  4. Clique em Salvar Alterações para criar a nova locação.

    A nova tenancy é exibida na lista Tenancies.

Usando a CLI do Serviço

  1. Crie uma nova tenancy com o comando create Tenant.

    As credenciais de nome, namespace e conta de administrador são parâmetros obrigatórios; uma descrição é opcional.

    Sintaxe (inserida em uma única linha):

    create Tenant 
name=<tenancy_name> 
serviceNamespace=<tenancy_namespace> 
description=<tenancy_description> 
adminUserName=<tenancy_admin_user_name> 
adminPassword=<tenancy_admin_password> 
confirmPassword=<tenancy_admin_password>

    Exemplo:

    RED2-ADMIN> create Tenant name=myTestTenancy serviceNamespace=test description="A tenancy for testing purposes" \
adminUserName=testadmin adminPassword=************ confirmPassword=************
JobId: a0ee398f-5d44-4b3f-8b9c-e5a9692c36a4
Data:
  id:ocid1.tenancy...<uniqueID>  name:myTestTenancy

  2. Use o ID do job para verificar o status do seu comando.

    RED2-ADMIN> show Job id=a0ee398f-5d44-4b3f-8b9c-e5a9692c36a4
Data:
  Id = a0ee398f-5d44-4b3f-8b9c-e5a9692c36a4
  Type = Job
  AssociatedObj = id:ocid1.tenancy.unique_ID  type:Tenant  name:myTestTenancy
  AssociatedObj Type = Tenant
  AssociatedObj Id = ocid1.tenancy.unique_ID
  Done = true
  Name = CREATE_TYPE
  Run State = Succeeded
[...]

  3. Verifique se a nova tenancy foi criada corretamente. Use os comandos list e show para exibir as informações da tenancy.

    RED2-ADMIN> list Tenant
Data:
  id                            name
  --                            ----
  ocid1.tenancy.unique_ID   myTestTenancy

RED2-ADMIN> show Tenant name=myTestTenancy
Data:
  Id = ocid1.tenancy.unique_ID
  Type = Tenant
  Name = myTestTenancy
  Description = A tenancy for testing purposes
  Service Namespace = test

  4. Forneça o URL da Interface do Usuário da Web do Compute, o nome da tenancy, o nome do usuário e a senha para o administrador da tenancy principal. A tenancy agora está pronta para uso.

    O administrador da tenancy configura contas de usuários adicionais, define compartimentos, políticas e outros recursos e geralmente configura o ambiente de nuvem para que os usuários possam começar a implantar seus recursos necessários.

Atualizando uma Tenancy

A única propriedade da tenancy que um administrador pode modificar no momento é a descrição.

  • UI do Service Web: Abra a página de detalhes da tenancy e clique em Editar.

  • CLI do Serviço: Use o comando edit Tenant name=<tenancy_name> description=<tenancy_description>

Excluindo uma Tenancy

Certifique-se de que os usuários da tenancy tenham removido todos os seus recursos. A tenancy só poderá ser excluída se estiver vazia.

Usando a UI da Web de Serviço

  1. No menu de navegação, clique em Tenancies.

  2. Na tabela de tenancies, clique no nome da tenancy que você deseja excluir.

    A página de detalhes da tenancy é exibida.

  3. No canto superior direito da página de detalhes da tenancy, clique em Excluir. Confirme a operação quando solicitado.

Usando a CLI do Serviço

  1. Procure o nome e o ID da tenancy que você deseja excluir.

    RED2-ADMIN> list Tenant
Data:
  id                            name
  --                            ----
  ocid1.tenancy.unique_ID   myTestTenancy

  2. Para excluir a tenancy, use o comando delete Tenant seguido pelo nome ou ID da tenancy.

    RED2-ADMIN> delete Tenant name=myTestTenancy
Status: Running
JobId: 92b84ac2-1f2c-41d7-980e-d7549957ef93

  3. Verifique se a tenancy excluída não é mais exibida na lista de tenancies.

    RED2-ADMIN> list Tenant
Data:
  id                            name
  --                            ----

Fornecendo Imagens do OCI

O OCI Images, também chamado de imagens de plataforma, é carregado no sistema durante a instalação do Roving Edge, e novas imagens de plataforma podem ser fornecidas durante operações de upgrade ou aplicação de patches. As imagens são colocadas em um local de armazenamento de dispositivo local acessível ao nó de gerenciamento.

Para permitir que os usuários implantem instâncias das imagens da plataforma, essas imagens também devem ser importadas para o Compute Enclave. Durante a atualização do dispositivo, a importação faz parte do processo normal. Se as imagens do OCI fornecidas pela Oracle não tiverem sido importadas corretamente ou se você tiver feito upload de imagens personalizadas para serem usadas por todos os usuários da tenancy, execute o comando importPlatformImages conforme descrito nesta seção.

Novas versões de uma imagem, adicionadas durante atualizações, nunca substituem nenhuma versão existente. Se as versões anteriores de uma imagem estiverem obsoletas e não estiverem mais disponíveis para os usuários, um administrador deverá excluir essas versões mais antigas manualmente, conforme descrito nesta seção. Se mais de três versões de uma imagem estiverem disponíveis, somente as três versões mais recentes serão mostradas quando as imagens forem listadas no Enclave de Computação. Imagens de plataforma mais antigas ainda estão disponíveis e podem ser selecionadas especificando o OCID da imagem.

Importando Imagens do OCI

Na CLI do Serviço, execute o comando importPlatformImages para disponibilizar todas as imagens que estão no local de armazenamento do dispositivo local para a tenancy.

RED2-ADMIN> importPlatformImages
JobId: f21b9d86-ccf2-4bd3-bab9-04dc3adb2966

Use o JobId para obter informações mais detalhadas sobre o job. No exemplo a seguir, nenhuma nova imagem foi entregue:

RED2-ADMIN> show job id=f21b9d86-ccf2-4bd3-bab9-04dc3adb2966
Data: 
  Id = f21b9d86-ccf2-4bd3-bab9-04dc3adb2966
  Type = Job
  Done = true
  Name = OPERATION
  Progress Message = There are no new platform image files to import
  Run State = Succeeded
Listando Imagens do OCI

Na CLI do Serviço, use o comando listPlatformImages para listar todas as imagens de plataforma que foram importadas do armazenamento compartilhado do cluster de gerenciamento.

RED2-ADMIN> listPlatformImages
Data:
  id                             displayName                                     lifecycleState
  --                             -----------                                     --------------
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Linux-7.9-2025.07.21_0.oci       AVAILABLE
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Linux-8-2025.09.16_0.oci         AVAILABLE
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Linux-9-2025.09.16_0.oci         AVAILABLE
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Linux8-OKE-1.32.7-20251127.oci   AVAILABLE
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Solaris-11-2025.10.16_0.oci      AVAILABLE

Os usuários da IU da Web do serviço Compute veem o mesmo lifecycleState que o listplatformImages mostra. Pouco depois da operação de importação, novas imagens são exibidas com o estado do ciclo de vida IMPORTING. Quando o job de importação é concluído, o estado do ciclo de vida é alterado para AVAILABLE.

Se você excluir uma imagem de plataforma, a CLI do Serviço e a UI da Web do serviço Compute listarão a imagem como DELETING ou DELETED.

Excluindo Imagens do OCI

Na CLI do Serviço, use o comando deleteplatformImage para excluir uma imagem de plataforma. A imagem é mostrada como DELETING e, em seguida, DELETED na saída da CLI do Serviço e no Enclave de Computação e, por fim, não é listada.

Importante

O comando deleteplatformImage não exclui o arquivo de imagem do armazenamento compartilhado. Também deve ser removido do sistema de arquivos. A execução do comando importPlatformImages reimporta a imagem e a torna disponível novamente no Enclave de Computação.

RED2-ADMIN> deleteplatformImage imageId=ocid1.image.unique_ID_7
JobId: 401567c3-3662-46bb-89d2-b7ad1541fa2d

RED2-ADMIN> listplatformImages
Data:
  id                             displayName                                     lifecycleState
  --                             -----------                                     --------------
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Linux-7.9-2025.07.21_0.oci       AVAILABLE
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Linux-8-2025.09.16_0.oci         AVAILABLE
[...]
  ocid1.cccimage...<unique_ID>   uln-pca-Oracle-Solaris-11-2025.10.16_0.oci      DELETED