Como criar um projeto - Amazon CodeCatalyst
Criação de um projeto vazioCriar um projeto com um repositório de terceiros vinculadoCriar um projeto com um esquemaPráticas recomendadas ao usar o Amazon Q para criar projetos ou adicionar funcionalidades com esquemasPráticas recomendadas para usar esquemas em projetosAdição de recursos e tarefas aos projetos criados

Como criar um projeto

Com os projetos do CodeCatalyst, você pode realizar tarefas de desenvolvimento com fluxos de trabalho e repositórios compartilhados de integração contínua/entrega contínua (CI/CD), gerenciar recursos, rastrear problemas e adicionar usuários.

Antes de criar um projeto, você deve ter o perfil de Administrador do espaço ou Usuário avançado.

Criação de um projeto vazio no Amazon CodeCatalyst

Você pode criar um projeto vazio sem recursos e adicionar manualmente os recursos desejados posteriormente.

Antes de criar um projeto, você deve ter o perfil de Administrador do espaço ou Usuário avançado.

Para criar um projeto vazio

  1. Navegue até o espaço onde você deseja criar um projeto.

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

  3. Escolha Começar do zero.

  4. Em Dê um nome ao projeto, insira o nome que você deseja atribuir ao projeto. O nome deve ser exclusivo em seu espaço.

  5. Escolha Criar projeto.

Criar um projeto com um repositório de terceiros vinculado

Você pode manter o código-fonte do projeto em um provedor de terceiros preferido e ainda usar todos os recursos do CodeCatalyst, como esquemas, gerenciamento do ciclo de vida, fluxos de trabalho e muito mais. Para fazer isso, você pode criar um projeto do CodeCatalyst vinculado a um repositório do GitHub, ao repositório do Bitbucket ou a um repositório de projetos do GitLab. Depois, você pode usar o repositório de origem vinculado no projeto CodeCatalyst.

Antes de criar um projeto do CodeCatalyst, você deve ter o perfil de Administrador do espaço ou Usuário avançado. Para ter mais informações, consulte Criar um espaço e Convite de um usuário diretamente para um espaço .

Para criar um projeto no CodeCatalyst vinculado a um repositório de origem na sua conta do GitHub, você precisará concluir as três tarefas a seguir:

  1. Instale os repositórios do GitHub, os repositórios do Bitbucket ou a extensão de repositórios do GitLab. Em um site externo, você precisa se conectar e fornecer ao CodeCatalyst acesso ao seu repositório, o que é feito como parte da próxima etapa.

    Importante

    Para instalar os repositórios do GitHub, os repositórios do Bitbucket ou a extensão dos repositórios do GitLab no seu espaço do CodeCatalyst, você deve estar conectado com uma conta que tenha o perfil de Administrador do espaço.

  2. Conecte sua conta do GitHub, espaço de trabalho do Bitbucket ou usuário do GitLab ao CodeCatalyst.

    Importante

    Para conectar sua conta do GitHub, espaço de trabalho do Bitbucket ou usuário do GitLab ao seu espaço do CodeCatalyst, você deve ser administrador da origem de terceiros e Administrador do espaço do CodeCatalyst.

    Importante

    Depois de instalar uma extensão de repositório, todos os repositórios vinculados ao CodeCatalyst terão seu código indexado e armazenado no CodeCatalyst. Isso tornará o código pesquisável no CodeCatalyst. Para entender melhor a proteção de dados do seu código ao usar repositórios vinculados no CodeCatalyst, consulte Proteção de dados no Guia do usuário do Amazon CodeCatalyst.

  3. Crie um projeto do CodeCatalyst vinculado ao seu repositório do GitHub, repositório do Bitbucket ou repositório de projetos do GitLab.

    Importante

    Embora você possa vincular um repositório do GitHub, do Bitbucket ou do projeto do GitLab como Colaborador, você só pode desvincular um repositório de terceiros como Administrador do espaço ou Administrador do projeto. Para ter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

    Importante

    O CodeCatalyst não comporta 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, primeiro você deve desvinculá-la do CodeCatalyst, alterar a ramificação padrão e vinculá-la novamente. Para ter mais informações, consulte Vínculo de repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab 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.

    nota

    • Um repositório do GitHub, do Bitbucket ou do projeto do GitLab só pode ser vinculado a um projeto do CodeCatalyst em um espaço.

    • Você não pode usar repositórios vazios ou arquivados do GitHub, repositórios do Bitbucket ou repositórios de projetos do GitLab com projetos do CodeCatalyst.

    • Você não pode vincular um repositório do GitHub, do Bitbucket ou do projeto do GitLab que tenha o mesmo nome de um repositório em um projeto do CodeCatalyst.

    • A extensão de Repositórios do GitHub não é compatível com os repositórios do GitHub Enterprise Server.

    • A extensão de Repositórios do Bitbucket não é compatível com os repositórios do Bitbucket Data Center.

    • A extensão de Repositórios do GitLab não é compatível com os repositórios de projetos autogerenciados do GitLab.

    • Não é possível usar os recursos Escrever descrição para mim ou Resumir comentários com repositórios vinculados. Esses recursos só estão disponíveis em solicitações pull no CodeCatalyst.

Para ter mais informações, consulte Adicionar funcionalidade a projetos com extensões no CodeCatalyst.

Para instalar a extensão de terceiros

  1. Navegue até o espaço onde você deseja criar um projeto.

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

  3. Selecione Traga seu próprio código.

  4. Em Vincular repositório existente, escolha repositórios do GitHub, repositórios do Bitbucket, repositórios do GitLab, dependendo do provedor de repositórios de terceiros que você deseja usar. Você precisa conectar sua conta do GitHub, espaço de trabalho do Bitbucket ou conta do GitLab, caso não tenha feito isso anteriormente. Se a extensão de terceiros de sua escolha ainda não estiver instalada, um prompt de instalação será exibido.

  5. Se solicitado, selecione Instalar. Revise as permissões exigidas pela extensão e, se quiser continuar, escolha Instalar novamente.

Depois de instalar a extensão de terceiros, a próxima etapa é conectar sua conta do GitHub, espaço de trabalho do Bitbucket ou usuário do GitLab ao seu espaço do CodeCatalyst.

Para conectar sua conta do GitHub, espaço de trabalho do Bitbucket ou usuário do GitLab ao CodeCatalyst

Faça o seguinte, dependendo da extensão de terceiros que você decidiu configurar:

  • Repositórios do GitHub: conecte a uma conta do GitHub.

    1. Selecione Conectar conta do GitHub para acessar o site externo do GitHub.

    2. Faça login na conta do GitHub usando suas credenciais do GitHub e escolha a conta na qual deseja instalar o Amazon CodeCatalyst.

      dica

      Se você já conectou uma conta do GitHub ao espaço, não poderá dar uma nova autorização. Em vez disso, haverá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se for membro ou colaborador em mais de um espaço do GitHub, ou a página de configuração da aplicação Amazon CodeCatalyst se você pertencer a apenas um espaço do GitHub. Configure a aplicação para o acesso ao repositório que você deseja permitir e selecione Salvar. Se o botão Salvar não estiver ativo, faça uma alteração na configuração e tente novamente.

    3. Escolha se você deseja permitir que o CodeCatalyst acesse todos os repositórios atuais e futuros ou escolha os repositórios específicos do GitHub que deseja usar no CodeCatalyst. A opção padrão é incluir todos os repositórios do GitHub na conta do GitHub, incluindo repositórios futuros que serão acessados pelo CodeCatalyst.

    4. Revise as permissões concedidas ao CodeCatalyst e escolha Instalar.

    Depois de conectar sua conta do GitHub ao CodeCatalyst, você será direcionado para a página de detalhes da extensão dos repositórios do GitHub, onde é possível visualizar e gerenciar contas do GitHub conectadas e repositórios do GitHub vinculados.

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

    1. Selecione Conectar espaço de trabalho do Bitbucket para acessar o site externo do Bitbucket.

    2. Faça login no espaço de trabalho do Bitbucket usando suas credenciais do Bitbucket e revise as permissões concedidas ao CodeCatalyst.

    3. No menu suspenso Autorizar para o espaço de trabalho, escolha o espaço de trabalho do Bitbucket ao qual você deseja fornecer acesso ao CodeCatalyst e, depois, selecione Conceder acesso.

      dica

      Se você já conectou um espaço de trabalho do Bitbucket ao espaço, não poderá dar uma nova autorização. Em vez disso, haverá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se for membro ou colaborador em mais de um espaço de trabalho do Bitbucket, ou a página de configuração da aplicação Amazon CodeCatalyst se você pertencer a apenas um espaço de trabalho do Bitbucket. Configure a aplicação para a qual você deseja permitir o acesso ao espaço de trabalho e selecione Conceder acesso. Se o botão Conceder acesso não estiver ativo, faça uma alteração na configuração e tente novamente.

    Depois de conectar seu espaço de trabalho do Bitbucket ao CodeCatalyst, você será direcionado para a página de detalhes da extensão dos repositórios do Bitbucket, onde é possível visualizar e gerenciar espaços de trabalho do Bitbucket conectados e repositórios do Bitbucket vinculados.

  • Repositórios do GitLab: conecte a um usuário do GitLab.

    1. Selecione Conectar usuário do GitLab para acessar o site externo do GitLab.

    2. Faça login no usuário do GitLab usando as credenciais do GitLab e revise as permissões concedidas ao CodeCatalyst.

      dica

      Se você já conectou um usuário do GitLab ao espaço, não poderá dar uma nova autorização. Em vez disso, você voltará ao console do CodeCatalyst.

    3. Selecione Autorizar o AWS Connector para o GitLab.

    Depois de conectar seu usuário do GitLab ao CodeCatalyst, você será direcionado para a página de detalhes da extensão dos repositórios do GitLab, onde é possível visualizar e gerenciar o usuário conectado do GitLab e os repositórios de projetos do GitLab vinculados.

Depois de conectar a fonte de terceiros ao CodeCatalyst, você pode vincular os repositórios de terceiros aos seus projetos do CodeCatalyst.

Para criar seu projeto

  1. Na página Criar projeto, escolha a conta do GitHub que você conectou.

  2. Dependendo do provedor de repositório de terceiros que você conectou, escolha o menu suspenso Repositórios do GitHub, Repositórios do Bitbucket ou Repositórios do GitLab para visualizar os repositórios de terceiros e, depois, escolha o repositório que deseja vincular ao seu projeto.

  3. No campo de entrada de texto Dê um nome ao projeto, insira o nome que você deseja atribuir ao projeto. O nome deve ser exclusivo em seu espaço.

  4. Escolha Criar projeto.

Depois de instalar os repositórios do GitHub, os repositórios do Bitbucket ou a extensão de repositórios do GitLab, conectar o provedor de recursos e vincular o repositório de terceiros ao projeto do CodeCatalyst, você pode usá-los nos fluxos de trabalho e nos ambientes de desenvolvimento do CodeCatalyst. Você também pode criar repositórios de terceiros na conta conectada do GitHub, no espaço de trabalho do Bitbucket ou no usuário do GitLab com código gerado em um esquema. Você também pode usar os repositórios vinculados com o Amazon Q Developer, esquemas e muito mais. Para ter mais informações, consulte Início automático da execução de um fluxo de trabalho após eventos de repositórios de terceiros e Criar um Ambiente de Desenvolvimento.

Criar um projeto com um esquema

Você pode provisionar todos os recursos do projeto e o código de amostra com um esquema do projeto. Para ter mais informações sobre esquemas, consulte Criação de um projeto abrangente com esquemas do CodeCatalyst.

Como criar um projeto com um esquema

  1. No console do CodeCatalyst, navegue até o espaço onde 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. Selecione um esquema na guia Esquemas do CodeCatalyst ou Esquemas de espaço e selecione Próximo.

  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 esquema é armazenado em um repositório do CodeCatalyst. Também é possível armazenar o código-fonte do esquema em um repositório de terceiros. Para ter mais informações, consulte Adicionar funcionalidade a projetos com extensões no CodeCatalyst.

    Importante

    O CodeCatalyst não comporta 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, primeiro você deve desvinculá-la do CodeCatalyst, alterar a ramificação padrão e vinculá-la novamente. Para ter mais informações, consulte Vínculo de repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab 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:

    • Repositórios do GitHub: conecte uma conta do GitHub.

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

      nota

      Se você estiver conectando com uma conta do GitHub, deverá criar uma conexão pessoal para estabelecer o mapeamento de identidade entre sua identidade do CodeCatalyst e sua identidade do GitHub. Para ter mais informações, consulte Conexões pessoais e Acesso a recursos do GitHub 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.

    • Repositórios do GitLab: conecte um usuário do GitLab.

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

  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.

Práticas recomendadas ao usar o Amazon Q para criar projetos ou adicionar funcionalidades com esquemas

Quando cria um projeto ou deseja adicionar novos componentes a um projeto existente, você pode não ter certeza sobre qual esquema usar ou como integrar recursos. O CodeCatalyst inclui integração com um assistente de IA generativa chamado Amazon Q, que pode analisar os requisitos do projeto e sugerir um esquema que melhor atenda às suas necessidades.

Você pode usar o Amazon Q para criar um projeto com um esquema que cria componentes com base em seus requisitos, ou você pode usar o Amazon Q para a adicionar um esquema a um projeto existente. Por exemplo, para adicionar recursos para uma aplicação web ou uma aplicação moderna a um projeto, especifique seus requisitos e, depois, os recursos serão adicionados com um esquema recomendado. Problemas com os componentes restantes podem ser criados para você.

O Amazon Q também cria problemas para requisitos que não podem ser resolvidos por meio de um esquema sugerido. Além disso, você pode atribuir esses problemas ao Amazon Q. Se você atribuir o problema ao Amazon Q, ele tentará criar uma solução preliminar para você avaliar. Isso pode ajudar você e sua equipe a se concentrarem e otimizarem o trabalho em questões que exigem sua atenção, enquanto o Amazon Q trabalha em uma solução para problemas que você não tem recursos para resolver imediatamente.

nota

Tecnologia da Amazon Bedrock: a AWS implementa a detecção automática de abusos. Como os recursos Escrever descrição para mim, Criar resumo do conteúdo, Recomendar tarefas, Usar o Amazon Q para criar ou adicionar recursos a um projeto e Atribuir problemas ao Amazon Q com os recursos do agente do Amazon Q Developer para desenvolvimento de software são baseados no Amazon Bedrock, os usuários podem aproveitar ao máximo os controles implementados no Amazon Bedrock para reforçar a segurança, a proteção e o uso responsável de inteligência artificial.

Confira a seguir algumas práticas recomendadas para ajudar você a criar projetos e adicionar esquemas com o Amazon Q.

Importante

Os recursos de IA generativa estão disponíveis somente na região Oeste dos EUA (Oregon).

  • Use os prompts padrão fornecidos pelo Amazon Q. O Amazon Q faz melhor ao escolher esquemas a partir dos prompts fornecidos.

  • Use as opções de configuração sugeridas pelo Amazon Q para visualizar os esquemas. Escolha um esquema para visualizar o código de amostra e os recursos que serão criados pelo esquema.

  • Use um espaço que esteja habilitado para o Amazon Q. Para criar um projeto com o Amazon Q ou adicionar funcionalidade a um projeto com esquemas usando o Amazon Q, use um espaço habilitado para recursos de IA generativa. Para ter mais informações, consulte Ativação ou desativação de recursos de IA generativa para um espaço.

  • Receba mais informações sobre os esquemas recomendados pelo Amazon Q. Talvez você queira saber mais sobre o tipo de recursos do projeto, o código de amostra e os componentes que são criados com um esquema específico recomendado. Para ter mais informações sobre esquemas disponíveis no CodeCatalyst, consulte Criação de um projeto abrangente com esquemas do CodeCatalyst.

  • Permita que o Amazon Q trabalhe com problemas. Permita que o Amazon Q crie problemas para você, atribua esses problemas e os acompanhe. Para ter mais informações, consulte Tutorial: Usar os recursos de IA generativa do CodeCatalyst para acelerar seu trabalho de desenvolvimento.

  • Cancele a atribuição do Amazon Q a problemas que não estão mais resolvidos. Depois de concluir o exemplo, cancele a atribuição do Amazon Q a quaisquer problemas que não estejam mais sendo resolvidos. Se o Amazon Q tiver concluído o trabalho em um problema ou não conseguir encontrar uma solução, cancele a atribuição do Amazon Q para evitar atingir a cota máxima de recursos de IA generativa. Para ter mais informações, consulte Gerenciamento de recursos de IA generativa e Preços.

  • Veja o uso do Amazon Q. Você pode visualizar o uso de recursos de IA generativa no nível do usuário. Acesse Minhas configurações para gerenciar cotas de IA generativa e visualizar o uso pelo ID do builder ou identidade de autenticação única (SSO). Para ter mais informações, consulte Visualização do uso de recursos de IA generativa em um espaço.

Importante

Os recursos de IA generativa no CodeCatalyst estão sujeitos a cotas. Para ter mais informações, consulte Preço do Amazon Q Developer, Ativação ou desativação de recursos de IA generativa para um espaço e Faturamento.

Práticas recomendadas para usar esquemas em projetos

Confira a seguir algumas práticas recomendadas para ajudar você a criar um projeto com esquemas ou adicionar esquemas.

  • Use os esquemas fornecidos pelo CodeCatalyst para criar ou adicionar aos projetos. Você pode usar esquemas para criar um projeto completo com código-fonte e recursos para desenvolvedores. Por exemplo, o esquema da aplicação web cria recursos de aplicação e infraestrutura e implanta uma aplicação web. Você pode criar um projeto com um esquema ou adicionar um esquema personalizado a um projeto existente. Para ter mais informações, consulte Criar um projeto com um esquema. Veja qualquer esquema no CodeCatalyst para visualizar o código de amostra e os recursos que serão criados pelo esquema.

  • Use esquemas personalizados criados pela sua organização. Você pode usar esquemas personalizados para criar um projeto completo em seu espaço. O esquema personalizado desenvolvido por sua organização pode fornecer padronização e práticas recomendadas, o que também pode ajudar a reduzir os esforços para configurar um novo projeto. Como autor de um esquema personalizado, você pode ver detalhes sobre quais projetos estão usando seu esquema em todo o seu espaço. O gerenciamento do ciclo de vida permite que você gerencie centralmente o ciclo de vida de desenvolvimento de software de cada projeto, e os usuários do esquema podem utilizar o gerenciamento do ciclo de vida para regenerar uma base de código a partir de opções ou versões atualizadas de um esquema. Para ter mais informações, consulte Trabalho com o gerenciamento do ciclo de vida como autor do esquema.

  • Adicione o perfil de desenvolvedor ou os perfis apropriados do IAM à conta do projeto. Durante ou depois de concluir as etapas de criação do projeto, você pode configurar as permissões do esquema escolhendo ou criando perfis do IAM em uma Conta da AWS que esteja conectada ao espaço.

Adição de recursos e tarefas aos projetos criados

Depois que o projeto estiver pronto, você poderá adicionar recursos e tarefas.