Introdução aos repositórios CodeCatalyst de origem e ao blueprint do aplicativo de página única

Como criar um projeto com um esquema

1. No CodeCatalyst console, navegue até o espaço em que você deseja criar um projeto.

2. No painel do espaço, escolha Criar projeto.

3. Selecione Começar com um esquema.

   dica

   Você pode optar por adicionar um esquema fornecendo ao Amazon Q os requisitos do projeto para que o Amazon Q sugira um esquema. Para ter mais informações, consulte Usar o Amazon Q para escolher um esquema ao criar um projeto ou adicionar funcionalidade e Práticas recomendadas ao usar o Amazon Q para criar projetos ou adicionar funcionalidades com esquemas. Esse recurso está disponível somente na região do Oeste dos EUA (Oregon).

   Essa funcionalidade exige que recursos de IA generativa estejam habilitados para o espaço. Para ter mais informações, consulte Gerenciar recursos de IA generativa.

4. Na guia CodeCatalyst Blueprints ou Space blueprints, escolha um blueprint e, em seguida, escolha Avançar.

5. Em Nomear seu projeto, insira o nome que você deseja atribuir ao seu projeto e os nomes dos recursos associados. O nome deve ser exclusivo em seu espaço.

6. (Opcional) Por padrão, o código-fonte criado pelo blueprint é armazenado em um CodeCatalyst repositório. Também é possível armazenar o código-fonte do esquema em um repositório de terceiros. Para obter mais informações, consulte Adicione funcionalidade a projetos com extensões no CodeCatalyst.

   Importante

   CodeCatalyst não suporta a detecção de alterações na ramificação padrão para repositórios vinculados. Para alterar a ramificação padrão de um repositório vinculado, você deve primeiro desvinculá-la CodeCatalyst, alterar a ramificação padrão e depois vinculá-la novamente. Para obter mais informações, consulte Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst.

   Como prática recomendada, sempre verifique se você tem a versão mais recente da extensão antes de vincular um repositório.

   Realize um destes procedimentos, dependendo do provedor de repositório de terceiros que você deseja usar:

   • GitHub repositórios: Conecte uma GitHub conta.

     Escolha o menu suspenso Avançado, escolha GitHub como provedor do repositório e, em seguida, escolha a GitHub conta na qual você deseja armazenar o código-fonte criado pelo blueprint.

     nota

     Se você estiver conectando uma GitHub conta, deverá criar uma conexão pessoal para estabelecer um mapeamento de identidade entre sua CodeCatalyst identidade e sua GitHub identidade. Para ter mais informações, consulte Conexões pessoais e Acessando GitHub recursos com conexões pessoais.

   • Repositórios do Bitbucket: conecte um espaço de trabalho do Bitbucket.

     Escolha o menu suspenso Avançado, selecione Bitbucket como provedor do repositório e, depois, escolha o espaço de trabalho do Bitbucket em que você deseja armazenar o código-fonte criado pelo esquema.

   • GitLab repositórios: Conecte um GitLab usuário.

     Escolha o menu suspenso Avançado, escolha GitLab como provedor do repositório e, em seguida, escolha o GitLab usuário no qual você deseja armazenar o código-fonte criado pelo blueprint.

7. Em Recursos do projeto, configure os parâmetros do esquema. Dependendo do esquema, você pode ter a opção de nomear o repositório de origem.

8. (Opcional) Para visualizar arquivos de definição com atualizações com base nas seleções de parâmetros do projeto que você fez, selecione Visualizar código ou Visualizar fluxo de trabalho em Gerar visualização do projeto.

9. (Opcional) Selecione Visualizar detalhes no cartão do esquema para visualizar detalhes específicos sobre o esquema, como uma visão geral da arquitetura do esquema, conexões e permissões necessárias e o tipo de recursos que o esquema cria.

10. Escolha Criar projeto.

Como navegar até os repositórios de origem de um projeto

1. Navegue até o projeto e faça o seguinte:

   • Na página de resumo do seu projeto, selecione o repositório que você deseja na lista e, depois, selecione Visualizar repositório.

   • No painel de navegação, selecione Código e, depois, selecione Repositórios de origem. Em Repositórios de origem, selecione o nome do repositório na lista. Você pode filtrar a lista de repositórios digitando parte do nome do repositório na barra de filtro.

2. Na página inicial do repositório, visualize o conteúdo do repositório e as informações sobre os recursos associados, como o número de solicitações pull e fluxos de trabalho. Por padrão, o conteúdo da ramificação padrão é exibido. Você pode alterar a visualização selecionando uma ramificação diferente na lista suspensa.

Para criar um Ambiente de Desenvolvimento com uma nova ramificação

1. Abra o CodeCatalyst console em https://codecatalyst.aws/.

2. Navegue até o projeto em que deseja criar um Ambiente de Desenvolvimento.

3. Selecione o nome do repositório na lista de repositórios de origem do projeto. Como alternativa, no painel de navegação, escolha Código, Repositórios de origem e selecione o repositório para o qual você deseja criar um Ambiente de Desenvolvimento.

4. Na página inicial do repositório, selecione Criar um ambiente de desenvolvimento.

5. Selecione um IDE compatível no menu suspenso. Consulte Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento para obter mais informações.

6. Escolha o repositório a ser clonado, selecione Trabalhar em uma nova ramificação, insira um nome de ramificação no campo Nome da ramificação e escolha uma ramificação a partir da qual criar a nova ramificação no menu Criar ramificação.

7. Opcionalmente, adicione um alias para o Ambiente de Desenvolvimento.

8. Opcionalmente, escolha o botão de edição da configuração do Ambiente de Desenvolvimento para editar a configuração de computação, armazenamento ou tempo limite do Ambiente de Desenvolvimento.

9. Escolha Criar. Enquanto seu Ambiente de Desenvolvimento estiver sendo criado, a coluna de status do Ambiente de Desenvolvimento exibirá Iniciando e a coluna de status exibirá Executando após a criação do Ambiente de Desenvolvimento. Uma nova guia será aberta com seu ambiente de desenvolvimento no IDE de sua escolha. Você pode editar o código, confirmar e enviar suas alterações.

Para fazer e promover uma mudança a partir de um ambiente de AWS Cloud9 desenvolvimento

1. Em AWS Cloud9, expanda o menu de navegação lateral para navegar pelos arquivos. Expanda src e abra App.tsx.

2. Faça uma alteração no texto dentro das tags <p>.

3. Salve o arquivo e, depois, confirme e envie suas alterações usando o menu Git. Como alternativa, na janela do terminal, confirme e envie suas alterações com os comandos git commit e git push.

   git commit -am "Making an example change"
   git push

   dica

   Talvez seja necessário alterar os diretórios no terminal para o diretório do repositório Git antes de executar com êxito os comandos do Git.

Para criar uma solicitação pull

1. Navegue até o projeto.

2. Execute um destes procedimentos:

   • No painel de navegação, escolha Código, Solicitações pull e, depois, selecione Criar solicitação pull.

   • Na página inicial do repositório, escolha Mais e, depois, selecione Criar solicitação pull.

   • Na página do projeto, selecione Criar solicitação pull.

3. No Repositório de origem, certifique-se de que o repositório de origem especificado seja aquele que contém o código confirmado. Essa opção só aparece se você não criou a solicitação pull na página principal do repositório.

4. Em Ramificação de destino, selecione a ramificação na qual mesclar o código depois que ele for revisado.

5. Em Ramificação de origem, selecione a ramificação que contém o código confirmado.

6. Em Título da solicitação pull, insira um título que ajude outros usuários a entender o que precisa ser revisado e por quê.

7. (Opcional) Na Descrição da solicitação pull, forneça informações, como um link para problemas ou uma descrição das alterações.

   dica

   Você pode escolher Escrever descrição para mim para gerar CodeCatalyst automaticamente uma descrição das alterações contidas na pull request. Você pode fazer alterações na descrição gerada automaticamente depois de adicioná-la à solicitação pull.

   Essa funcionalidade exige que os recursos de IA generativa estejam habilitados para o espaço e não estejam disponíveis para solicitações pull em repositórios vinculados. Para ter mais informações, consulte Gerenciar recursos de IA generativa.

8. (Opcional) Em Problemas, selecione Vincular problemas e, depois, selecione um problema na lista ou insira seu ID. Para desvincular um problema, selecione o ícone de desvinculação.

9. (Opcional) Em Revisores obrigatórios, selecione Adicionar revisores obrigatórios. Selecione na lista de membros do projeto para adicioná-los. Os revisores obrigatórios devem aprovar as alterações antes que a solicitação pull seja mesclada na ramificação de destino.

   nota

   Não é possível adicionar um revisor como revisor obrigatório e revisor opcional. Não é possível se adicionar como revisor.

10. (Opcional) Em Revisores opcionais, selecione Adicionar revisores opcionais. Selecione na lista de membros do projeto para adicioná-los. Revisores opcionais não precisam aprovar as alterações como um requisito antes que a solicitação pull seja mesclada na ramificação de destino.

11. Revise as diferenças entre as ramificações. A diferença exibida em uma solicitação pull são as alterações entre a revisão na ramificação de origem e a base de mesclagem, que é a confirmação principal da ramificação de destino no momento em que a solicitação pull foi criada. Se nenhuma alteração for exibida, as ramificações podem ser idênticas ou você pode ter escolhido a mesma ramificação para a origem e o destino.

12. Quando a solicitação pull tiver o código e as alterações que você deseja revisar, selecione Criar.

    nota

    Depois que você criar a solicitação pull, poderá adicionar comentários. Os comentários podem ser adicionados à solicitação pull ou a linhas individuais em arquivos, bem como à solicitação pull geral. Você pode adicionar links para recursos, como arquivos, usando o sinal @ seguido pelo nome do arquivo.

Como mesclar uma solicitação pull (console)

1. Em Solicitações pull, escolha a solicitação pull que você criou na etapa anterior. Na solicitação pull, selecione Mesclar.

2. Selecione entre as estratégias de mesclagem disponíveis para a solicitação pull. Também é possível selecionar ou desmarcar a opção de excluir a ramificação de origem depois de mesclar a solicitação pull e, depois, selecionar Mesclar. Após a conclusão da mesclagem, o status da solicitação pull muda para Mesclado e não aparece mais na visualização padrão das solicitações pull. A visualização padrão mostra solicitações pull com o status Aberto. Você ainda pode visualizar uma solicitação pull mesclada, mas não pode aprová-la ou alterar seu status.

   nota

   Se o botão Mesclar não estiver ativo ou você ver o rótulo Não mesclável, um revisor obrigatório ainda não aprovou a pull request ou a pull request não pode ser mesclada no console. CodeCatalyst Um revisor que não aprovou uma solicitação pull é indicado por um ícone de relógio em Visão geral na área Detalhes da solicitação pull. Se todos os revisores obrigatórios aprovaram a solicitação pull, mas o botão Mesclar ainda não estiver ativo, você pode ter um conflito de mesclagem ou ter excedido a cota de armazenamento do espaço. Você pode resolver conflitos de mesclagem para a ramificação de destino em um ambiente de desenvolvimento, enviar as alterações e, em seguida, mesclar a pull request, ou você pode resolver conflitos e mesclar localmente e, em seguida, enviar a confirmação que contém a mesclagem para. CodeCatalyst Para ter mais informações, consulte Mescla de uma solicitação pull (Git) e a documentação do Git.

Como visualizar o código implantado

1. Em Fluxos de trabalho, em onPushToMainDeployPipeline, expanda Execuções recentes.

   nota

   Esse é o nome padrão do fluxo de trabalho para projetos criados com o esquema de Aplicação de página única.

2. A execução mais recente é aquela iniciada pela confirmação da solicitação pull mesclada na ramificação main e provavelmente exibirá o status Em andamento. Selecione uma execução concluída com sucesso na lista para abrir os detalhes dessa execução.

3. Selecione Variáveis. Copie o valor para AppURL. Esse é o URL da aplicação web de página única implantada. Abra uma nova guia do navegador e cole o valor para visualizar o código compilado e implantado. Deixe a guia aberta.

4. Retorne à lista de execuções do fluxo de trabalho e aguarde a conclusão da execução mais recente. Quando isso acontecer, retorne à guia aberta para visualizar a aplicação web e atualizar seu navegador. Veja as alterações feitas na sua solicitação pull mesclada.