Antes de começar a trabalhar nas tarefas de configuração essenciais, é importante entender como suas instâncias do Oracle Cloud Application e do VB Studio são organizadas.

A Oracle está no processo de provisionamento de várias instâncias do Visual Builder Studio para cada cliente do Oracle Cloud Applications. Os novos clientes verão essa configuração assim que forem provisionados com o Oracle Cloud Applications; os clientes existentes serão migrados para o novo cenário nos próximos meses. Nesta nova configuração, cada instância de TESTE e DEV em sua família de ambientes do Oracle Cloud Application recebe sua própria instância do VB Studio, que por sua vez são vinculadas por uma única organização do VB Studio:

Descrição da ilustração shell-instances.png

Ao compartilhar uma organização comum, os usuários que trabalham no VB Studio associados a uma instância de TESTE, por exemplo, podem acessar os mesmos projetos, repositórios e extensões que os usuários que trabalham em uma instância completamente diferente — digamos, uma instância DEV vinculada a outra instância do VB Studio ou outra instância de TESTE. Eles podem ver as alterações uns dos outros, revisar e aprovar as solicitações de mesclagem uns dos outros e colaborar nas mesmas wikis, tudo como se estivessem na mesma instância do VB Studio.

Aqui estão algumas considerações importantes a serem consideradas ao usar várias instâncias do VB Studio:

• Você pode usar diferentes instâncias do VB Studio para diferentes finalidades. Por exemplo, você pode manter uma ou mais extensões usando o VB Studio em sua instância de TESTE, enquanto avalia simultaneamente uma nova funcionalidade em uma próxima versão do Oracle Cloud Applications usando um VB Studio diferente (provavelmente um associado a uma instância DEV executando a versão mais recente).
• Em seu ambiente do Oracle Cloud Applications, sua identidade é diferente em cada instância do VB Studio com a qual você está trabalhando. Por exemplo, na instância de desenvolvimento DEV1, seu nome de usuário pode ser conhecido como UserA@<Oracle Cloud Applications-instance-name>-DEV1 para o VB Studio; UserB pode ser UserB@<Oracle Cloud Applications-instance-name>-DEV2 e assim por diante. Isso significa que o administrador pode precisar designar atribuições para você várias vezes, uma para cada nome de usuário/identidade. Isso também significa que, para trabalhar no mesmo projeto de Dev1 e Dev2, ambos os seus nomes de usuário/identidades devem ser adicionados a esse projeto.
• Ter várias instâncias do VB Studio oferece flexibilidade caso a instância em que você normalmente trabalha não esteja disponível por algum motivo. Por exemplo, suponha que você geralmente trabalhe no Projeto A na instância DEV1, mas DEV1 esteja inativo para manutenção. Desde que sua identidade em DEV2 também seja membro do Projeto A – e supondo que você tenha enviado suas últimas alterações ao Git – você poderá acessar o projeto por meio do VB Studio associado ao DEV2 e retomar seu trabalho a partir daí. (Consulte Configurar Usuários do VB Studio para obter mais informações sobre identidades de usuários.) Observe que DEV1 e DEV2 devem estar executando a mesma release do Oracle Cloud Applications para que esse cenário funcione corretamente.
• Você deve desenvolver suas extensões somente na instância do VB Studio associada à instância do Oracle Cloud Applications na qual está trabalhando. Ou seja, se você usar DEV1 para criar suas extensões, certifique-se de estar usando o VB Studio associado a DEV1 e não, digamos, a instância do VB Studio associada ao TEST, ou uma instância do VB Studio em uma família de ambientes completamente diferente do Oracle Cloud Applications. É claro que você pode implantar extensões para qualquer instância em qualquer família de ambientes, desde que tenha um ambiente VB Studio definido para suportar isso.
• Para implantar uma extensão em uma instância PROD (ou excluir uma extensão quando ela não for mais necessária), use sempre a página Gerenciar Extensão do Ciclo de Vida. A única razão para não fazer isso é se algum trabalho de extensão tiver sido isolado em ramificações discretas, o que significa que você precisará empregar CI/CD; nesse caso, consulte Implantar na Produção por meio de Pipelines CI/CD.
• Se você estiver desenvolvendo uma extensão em uma instância e quiser testá-la em outra:
  • Defina um novo ambiente. A maneira mais fácil é ir para a guia Ambientes no navegador esquerdo do VB Studio e, em seguida, clicar em Ciclo de Vida de Extensão:
    
    
    Descrição da ilustração extlifecycle.png
    
    Se você usar o botão + Criar Ambiente, certifique-se de selecionar OAuth 2.0 em Tipo de Autorização:
    
    
    Descrição da ilustração addserviceoauth.png
    
    Independentemente do método escolhido, informe o URL base, o nome pelo qual você deseja fazer referência à instância e as credenciais de um usuário autorizado a implantar na instância. Essas credenciais devem ser as de um usuário local, não uma identidade federada, e não devem exigir autenticação multifator. Depois que a instância é conectada, essas credenciais são descartadas; elas são necessárias apenas para configurar a conexão inicial baseada em OAuth.
  • De volta ao Designer, pressione o botão Publicar para confirmar as alterações feitas na extensão para o repositório Git no VB Studio.
  • Use a página Gerenciar Extensão do Ciclo de Vida para implantar a extensão no ambiente que você acabou de criar, bem como para manter o controle sobre todas as suas implantações.
  Observação
  
  Se você não puder ver as implantações de uma determinada instância, provavelmente será porque a instância não foi criada usando OAuth. Para resolver esse problema, crie um novo ambiente que aponte para a instância, especificando OAuth 2.0 como o método de autenticação. (Se você criar o ambiente na página Gerenciar Ciclo de Vida da Extensão, OAuth será usado automaticamente.)
• Conforme mostrado na imagem acima, cada instância não Produção em uma família de ambientes do Oracle Cloud App está associada à sua própria instância do VB Studio, que por sua vez está vinculada a uma única organização. Se você tiver a atribuição do IDCS DEVELOPER_ADMINISTRATOR para qualquer uma dessas instâncias do VB Studio (ou se tiver a atribuição APPLICATION_ADMINISTRATOR em qualquer uma das instâncias do Aplicativo Oracle Cloud não Prod com a sincronização de atribuição do IDCS ativada), será considerado um administrador da organização do VB Studio. Nessa capacidade, todas as alterações feitas na organização por meio de qualquer das instâncias do VB Studio também são refletidas em todas as outras instâncias da família de ambientes.
• Da mesma forma, se você tiver as políticas da OCI que permitem administrar instâncias do VB Studio na console da OCI, qualquer alteração feita por meio da console, por exemplo, ativar CI/CD para uma única instância do VB Studio, afetará toda a organização. Ou seja, ativar CI/CD para uma instância permite isso para todas as instâncias da família de ambientes.

Deseja criar aplicativos visuais com uma das instâncias do VB Studio provisionadas junto com sua conta do Oracle Cloud Applications? Você certamente pode fazer isso, mas precisará de uma instância do Visual Builder para implantá-los. Além disso, como cada instância do VB Studio é provisionada no mesmo segmento de identidade que sua instância associada do Oracle Cloud Applications (TEST, DEV1, DEVn etc.), cada desenvolvedor de aplicativo visual precisará das credenciais do Oracle Cloud Application para acessar o VB Studio. Além disso, se sua instância do Oracle Cloud Application estiver inativa para manutenção ou por algum outro motivo, a instância associada do VB Studio também não estará disponível, o que significa que o desenvolvimento de aplicativos visuais será interrompido.

Como alternativa, você pode usar a console do Oracle Cloud para criar sua própria instância do VB Studio para desenvolver seus aplicativos visuais, se tiver a capacidade de fazê-lo, embora ainda precise de uma instância separada do Visual Builder para implantação.