Criar e Configurar um Projeto para Desenvolvimento

Um projeto reúne todos os recursos necessários para desenvolver software, neste caso, um projeto para aplicações visuais.

Depois de configurar o VB Studio para desenvolver aplicativos visuais, siga as etapas desta tabela para criar um projeto vazio, adicionar um ambiente com uma instância do Visual Builder, configurar o job de implantação e adicionar usuários ao projeto. Quando sua instância do VB Studio estiver em um domínio de identidades diferente da instância do Visual Builder, você também precisará autorizar a conexão com sua instância do Visual Builder.

Dica:

Em vez de criar um projeto vazio e configurá-lo manualmente (conforme descrito aqui), você pode usar o modelo Visual Application para criar rapidamente um projeto com tudo o que você precisa para desenvolver aplicativos visuais. Observe que essa opção só está disponível quando sua instância do VB Studio está no mesmo domínio de identidades que sua instância do Visual Builder. Consulte Criar e Configurar um Projeto Usando o Modelo de Aplicativo Visual.
Ação Como Fazer
1. Crie um projeto VB Studio vazio.
  1. Acesse o VB Studio. Consulte Acessar o VB Studio na Home Page do Oracle Cloud.
  2. Na página Organização, clique em + Criar.
  3. Na página Detalhes do Projeto, informe um nome e uma descrição exclusivos para o projeto.
  4. Em Segurança, selecione a definição de privacidade do projeto.

    Um projeto privado só pode ser acessado por usuários convidados. Os usuários que não são convidados não podem acessá-lo ou fazer alterações nele. Você pode convidar usuários após criar o projeto.

    Um projeto compartilhado é acessível a todos os usuários da organização. Qualquer usuário pode visualizar o código-fonte, criar ou atualizar problemas, editar páginas wiki e interagir com builds de projetos. No entanto, somente usuários convidados podem fazer atualizações no código-fonte nos repositórios Git, criar e executar jobs de build e executar operações de implantação.

  5. Em Idioma Preferencial, especifique o idioma das notificações por e-mail que os usuários do projeto receberão. Você pode alterar o idioma no qual a interface do usuário aparece em suas preferências de usuário.
  6. Clique em Próximo.
  7. Na página Modelo, selecione o modelo Projeto Vazio e clique em Próximo.
  8. Na página Propriedades, selecione o tipo de marcação wiki e clique em Finalizar.

Depois que o projeto é provisionado, a Home page do Projeto é aberta, onde você pode ver um resumo das atividades de provisionamento do projeto. Verifique se há erros no feed de atividades.

2. No projeto, crie um ambiente com sua instância do Visual Builder.
Observação

Antes de tentar criar um ambiente, certifique-se de que sua instância do VB Studio esteja autorizada a acessar as instâncias do Visual Builder conectadas à sua conta do OCI. Sem essa autorização, essas instâncias não estarão disponíveis para seleção em seu ambiente como destino de implantação. Consulte Autorizar o VB Studio a Acessar Instâncias do Visual Builder e do Integration.
  1. No menu de navegação, clique em Ambientes Ambientes e, em seguida, clique em + Criar Ambiente.
  2. Em Nome do Ambiente e Descrição, digite um nome e uma descrição exclusivos e clique em Criar.
  3. Na guia Instâncias de Serviço do ambiente, clique em Adicionar Instância.
  4. Localize e adicione sua instância do Visual Builder:
    1. Certifique-se de que o Tipo de Instância esteja definido como Visual Builder e Adicionar Instância Usando esteja definido como Lista de Instâncias. Esta é a abordagem preferida.
    2. Clique em Alterar Detalhes do OCI ao lado de Detalhes do OCI, selecione a região e o compartimento em que sua instância do Visual Builder está e clique em Atualizar.
    3. Selecione sua instância do Visual Builder na lista de instâncias do compartimento selecionado e clique em Adicionar.

    Se você não vir a instância que deseja adicionar (porque ela está conectada a outra conta do OCI), selecione Credenciais do Visual Builder em Adicionar Instância Usando. Em URL Base, informe o URL da instância do Visual Builder; atualize o Nome da Instância, se necessário; informe as credenciais de um usuário que pode acessar a instância do Visual Builder em Nome do Usuário e Senha; e clique em Adicionar. Observe que o uso dessa abordagem não permitirá que você configure OAuth para esse ambiente no job de build de implantação, usado pela ação Publicar no Designer.

  5. Se sua instância de destino usar um domínio de identidades diferente da instância do VB Studio, os tokens OAuth (por meio de fluxos OAuth de três etapas) serão usados para proteger o acesso programático à instância. Para que qualquer token OAuth possa ser criado, você deve fornecer autorização para adquirir tokens OAuth. Clique em Autorizar quando solicitado e, em seguida, acesse com credenciais para estabelecer conexão e implantar na instância de destino.

Quando terminar, o feed Atividades Recentes na Home page do Projeto lista o ambiente recém-criado junto com a instância do Visual Builder adicionada.

3. Quando estiverem prontos, os usuários poderão criar um espaço de trabalho no projeto.
  1. No menu de navegação, clique em Espaços de Trabalho Designer.
  2. Clique em Novo e selecione Novo Aplicativo Visual.
  3. Em Nome do Espaço de Trabalho, adicione um nome para seu espaço de trabalho.
  4. Em Ambiente de Desenvolvimento, selecione o ambiente criado na etapa anterior.
  5. Em Modelo de Aplicativo Visual, não altere o padrão (Aplicativo VB Padrão).
  6. Em Repositório Git, selecione Criar novo repositório e informe um nome de repositório e um nome de ramificação de trabalho.
4. O usuário que criou o aplicativo visual precisará configurar seu job de implantação.
  1. No menu de navegação do Visual Builder Studio, clique em Builds Builds.
  2. Na guia Jobs, clique no job de implantação.
  3. Clique em Configurar e, em seguida, clique na guia Etapas.
  4. Em Instância de Destino, certifique-se de que o ambiente criado na Etapa 2 esteja selecionado.
  5. Na seção Autorização, especifique o tipo de autorização para executar esta etapa de criação. Com a opção Usar OAuth selecionada por padrão, você verá a mensagem Authorization is required, indicando que essa etapa de build precisa de uma autorização única para tratar solicitações OAuth para a instância do Visual Builder do seu ambiente. Clique em Autorizar e informe credenciais para acessar sua instância do Visual Builder; você também pode executar o job manualmente e informar as credenciais quando solicitado.

    De qualquer forma, é recomendável autorizar sua conexão OAuth durante a configuração inicial. Se você ignorar esta etapa, não poderá publicar suas alterações no Designer e precisará concluir a autorização necessária antes de tentar implantar as alterações.

    Uma vez autorizada, a mensagem Authorization has been provided é exibida.

    Observação

    OAuth é o tipo de autorização recomendado. Use a autenticação Básica somente se tiver problemas ao configurar uma conexão OAuth. Para usar a autenticação Básica, selecione Usar Básico e informe as credenciais de um usuário que pode acessar a instância do Visual Builder em Nome do Usuário e Senha.

    Os tokens OAuth (acesso e atualização) são reiniciados durante o uso regular. Um token de atualização é usado para obter um token de acesso sempre que um usuário acessa a instância de destino. Esse token de atualização geralmente é válido por sete dias. (O tempo de expiração do token é definido no aplicativo de recursos do IDCS e pode ser diferente com base em seus requisitos de segurança.) Se o usuário se autenticar com a instância de destino dentro do período de sete dias, o token de atualização ativo gerará um novo token de acesso e um novo token de atualização. Esse ciclo continua indefinidamente, desde que o token de atualização permaneça válido. Se o token de atualização expirar durante longos períodos de inatividade (por exemplo, quando você estiver de férias), clique em Renovar Autorização (ou execute o job manualmente, para que você seja solicitado a autorizar quaisquer tokens OAuth expirados).

  6. (Opcional) Escolha Usar nomes de arquivo personalizados e adicione detalhes do nome de arquivo personalizado.
  7. (Opcional) Para substituir a versão padrão do aplicativo, especifique a nova versão em Versão do Aplicativo. Deixe-o vazio para usar a versão definida no arquivo visual-application.json do aplicativo.

    Não desmarque a caixa de seleção Incluir a versão do aplicativo no URL.

  8. (Opcional) Em Perfil do Aplicativo, especifique o perfil do aplicativo de desenvolvimento. Deixe-o vazio para usar o perfil padrão do aplicativo.

    Usando perfis de aplicativo, você pode definir diferentes combinações de servidores e configurações de segurança para cada um dos seus ambientes e usá-los ao implantar o aplicativo em um ambiente. Para saber mais, consulte O que São Perfis de Aplicativo?

  9. (Opcional) Para usar o banco de dados do aplicativo existente, em Gerenciamento de Dados, selecione Manter dados do ambiente existente. Para usar um banco de dados limpo para a aplicação, em Gerenciamento de Dados, selecione Usar banco de dados limpo.
  10. Clique em Salvar.
5. Adicione usuários ao projeto. Para permitir que os membros da sua equipe acessem o projeto de aplicativo visual, convide-os a se associar ao projeto. Consulte Adicionar Usuários ao Projeto.