Como criar um projeto - Amazon CodeCatalyst
Criando um projeto vazioCriação de um projeto com um repositório de terceiros vinculadoCriando um projeto com um blueprintMelhores práticas ao usar o Amazon Q para criar projetos ou adicionar funcionalidades com blueprintsMelhores práticas para usar esquemas com projetosAdicionar recursos e tarefas aos projetos criados

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como criar um projeto

Com CodeCatalyst projetos, você pode realizar tarefas de desenvolvimento com fluxos de trabalho e repositórios compartilhados integration/continuous delivery (CI/CD (contínuos), gerenciar recursos, rastrear problemas e adicionar usuários.

Antes de criar um projeto, você deve ter a função de administrador do espaço ou usuário avançado.

Criando um projeto vazio na 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 a função 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.

Criação de um projeto com um repositório de terceiros vinculado

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

Antes de criar um CodeCatalyst projeto, você deve ter a função de administrador do espaço ou usuário avançado. Para ter mais informações, consulte Criando um espaço e Convidar um usuário diretamente para um espaço .

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

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

    Importante

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

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

    Importante

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

    Importante

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

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

    Importante

    Embora você possa vincular um GitHub repositório, um repositório do Bitbucket ou um repositório GitLab do projeto como colaborador, você só pode desvincular um repositório de terceiros como administrador do Space ou administrador do projeto. Para obter mais informações, consulte Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira 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.

    nota

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

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

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

    • A extensão GitHub repositories 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 GitLab repositories não é compatível com repositórios de projetos GitLab autogerenciados.

    • Você não pode usar os recursos Escrever descrição para mim ou Resumir comentários com repositórios vinculados. Esses recursos só estão disponíveis em pull requests em CodeCatalyst.

Para obter mais informações, consulte Adicione 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. Escolha Traga seu próprio código.

  4. Em Vincular repositório existente, escolha repositórios, GitHub repositórios do Bitbucket, repositórios dependendo do provedor de GitLab repositórios terceirizado que você deseja usar. Você será solicitado a conectar sua GitHub conta, espaço de trabalho do Bitbucket ou GitLab conta, 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, escolha 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 GitHub conta, espaço de trabalho do Bitbucket ou GitLab usuário ao seu CodeCatalyst espaço.

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

Siga um destes procedimentos, dependendo da extensão de terceiros que você escolheu configurar:

  • GitHub repositórios: conecte-se a uma GitHub conta.

    1. Escolha Connect GitHub account para acessar o site externo GitHub.

    2. Faça login na sua GitHub conta usando suas GitHub credenciais e, em seguida, escolha a conta na qual você deseja instalar a Amazon CodeCatalyst.

      dica

      Se você já conectou uma GitHub conta ao espaço, não será solicitado que você reautorize. Em vez disso, você verá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se você for membro ou colaborador em mais de um GitHub espaço, ou a página de configuração do CodeCatalyst aplicativo Amazon se você pertencer a apenas um GitHub espaço. Configure o aplicativo para o acesso ao repositório que você deseja permitir e escolha 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 o acesso CodeCatalyst a todos os repositórios atuais e futuros ou escolha os GitHub repositórios específicos nos quais deseja usar. CodeCatalyst A opção padrão é incluir todos os GitHub repositórios na GitHub conta, incluindo repositórios futuros que serão acessados pelo. CodeCatalyst

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

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

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

    1. Escolha o espaço de trabalho Connect Bitbucket para acessar o site externo do Bitbucket.

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

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

      dica

      Se você já conectou um espaço de trabalho do Bitbucket ao espaço, não será solicitado que você reautorize. Em vez disso, você verá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se você for membro ou colaborador em mais de um espaço de trabalho do Bitbucket, ou a página de configuração do CodeCatalyst aplicativo Amazon se você pertencer a apenas um espaço de trabalho do Bitbucket. Configure o aplicativo para o acesso ao espaço de trabalho que você deseja permitir e escolha 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 de repositórios do Bitbucket, onde poderá visualizar e gerenciar espaços de trabalho do Bitbucket conectados e repositórios vinculados do Bitbucket.

  • GitLab repositórios: conecte-se a um GitLab usuário.

    1. Escolha Connect GitLab user para acessar o site externo GitLab.

    2. Faça login com seu GitLab usuário usando suas GitLab credenciais e revise as permissões concedidas a. CodeCatalyst

      dica

      Se você já conectou um GitLab usuário ao espaço, não será solicitado que você reautorize. Em vez disso, você será direcionado de volta ao CodeCatalyst console.

    3. Escolha Autorizar AWS conector para GitLab.

    Depois de conectar seu GitLab usuário ao CodeCatalyst, você será direcionado para a página de detalhes da extensão de GitLab repositórios, onde poderá visualizar e gerenciar repositórios de GitLab usuários e GitLab projetos vinculados.

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

Para criar seu projeto

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

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

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

  4. Escolha Criar projeto.

Depois de instalar os GitHub repositórios, os repositórios do Bitbucket ou a extensão de GitLab repositórios, conectar seu provedor de recursos e vincular seu repositório de terceiros ao seu CodeCatalyst projeto, você pode usá-lo em fluxos de trabalho e ambientes de desenvolvimento. CodeCatalyst Você também pode criar repositórios de terceiros na GitHub conta conectada, no espaço de trabalho do Bitbucket ou no GitLab usuário com código gerado a partir de um blueprint. Você também pode usar os repositórios vinculados com o Amazon Q Developer, blueprints e muito mais. Para ter mais informações, consulte Iniciando automaticamente a execução de um fluxo de trabalho após eventos de repositórios de terceiros e Criar um ambiente de desenvolvimento.

Criando um projeto com um blueprint

Você pode provisionar todos os recursos do projeto e o código de amostra com um blueprint do projeto. Para obter informações sobre plantas, consulte o. Criando um projeto abrangente com CodeCatalyst plantas

Para criar um projeto com um blueprint

  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. Escolha Começar com um blueprint.

    dica

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

    Essa funcionalidade exige que recursos generativos de IA estejam habilitados para o espaço. Para obter mais informações, consulte Gerenciamento de recursos generativos de IA.

  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. Como alternativa, você pode optar por armazenar o código-fonte do blueprint 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.

    Faça o seguinte, dependendo do provedor de repositório terceirizado 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, escolha Bitbucket como provedor de repositório e, em seguida, escolha o espaço de trabalho do Bitbucket em que você deseja armazenar o código-fonte criado pelo blueprint.

    • 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 blueprint. Dependendo do blueprint, você pode ter a opção de nomear o nome do 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, escolha Exibir código ou Exibir fluxo de trabalho em Gerar visualização do projeto.

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

  10. Escolha Criar projeto.

Melhores práticas ao usar o Amazon Q para criar projetos ou adicionar funcionalidades com blueprints

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

Você pode usar o Amazon Q para ajudá-lo a criar um projeto com um blueprint que cria componentes com base em seus requisitos, ou você pode usar o Amazon Q para ajudá-lo a adicionar um blueprint a um projeto existente. Por exemplo, para adicionar recursos para um aplicativo web ou aplicativo moderno a um projeto, especifique seus requisitos e, em seguida, 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 plano sugerido. Além disso, você pode atribuir esses problemas à Amazon Q. Se você atribuir o problema à Amazon Q, ela 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

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

A seguir estão algumas das melhores práticas para ajudar você a criar projetos e adicionar plantas com o Amazon Q.

Importante

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

  • Use os prompts padrão fornecidos pela Amazon Q. O Amazon Q faz melhor ao escolher plantas a partir das instruções fornecidas.

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

  • 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 plantas usando o Amazon Q, use um espaço habilitado para recursos generativos de IA. Para obter mais informações, consulte Ativar ou desativar recursos generativos de IA para um espaço.

  • Obtenha mais informações sobre os projetos recomendados pela 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 obter mais informações sobre os blueprints disponíveis em CodeCatalyst, consulteCriando um projeto abrangente com CodeCatalyst plantas.

  • Permita que o Amazon Q trabalhe com problemas. Permita que a Amazon Q crie problemas para você, atribua esses problemas e os acompanhe. Para obter mais informações, consulte Tutorial: Usando recursos CodeCatalyst generativos de IA 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 seu trabalho em um problema ou não conseguir encontrar uma solução, certifique-se de cancelar a atribuição do Amazon Q para evitar atingir a cota máxima de recursos generativos de IA. Para obter mais informações, consulte Gerenciamento de recursos e preços generativos de IA.

  • Veja o uso do Amazon Q. Você pode visualizar o uso de recursos generativos de IA no nível do usuário. Acesse Minhas configurações para gerenciar cotas generativas de IA e visualizar o uso por sua ID do Builder ou identidade de login único (). SSO Para obter mais informações, consulte Visualização do uso de recursos generativos de IA em um espaço.

Importante

Os recursos generativos de IA CodeCatalyst estão sujeitos a cotas. Para obter mais informações, consulte Amazon Q Developer Pricing, Ativação ou desativação de recursos generativos de IA para um espaço e Faturamento.

Melhores práticas para usar esquemas com projetos

A seguir estão algumas das melhores práticas para ajudá-lo a criar um projeto com plantas ou adicionar plantas.

  • Use os esquemas fornecidos por CodeCatalyst para criar ou adicionar aos projetos. Você pode usar blueprints para criar um projeto completo com código-fonte e recursos para desenvolvedores. Por exemplo, o blueprint do aplicativo web cria recursos de aplicativo e infraestrutura e implanta um aplicativo web. Você pode criar um projeto com um blueprint ou adicionar um blueprint personalizado a um projeto existente. Para obter mais informações, consulte Criando um projeto com um blueprint. Visualize qualquer blueprint CodeCatalyst para visualizar o código de amostra e os recursos que serão criados pelo blueprint.

  • Use esquemas personalizados criados pela sua organização. Você pode usar plantas personalizadas para criar um projeto completo em seu espaço. O plano personalizado desenvolvido por sua organização pode fornecer padronização e melhores práticas, o que também pode ajudar a reduzir os esforços para configurar um novo projeto. Como autor de um blueprint personalizado, você pode ver detalhes sobre quais projetos estão usando seu blueprint 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 blueprint 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 blueprint. Para obter mais informações, consulte Trabalhando com o gerenciamento do ciclo de vida como autor do plano.

  • Adicione a função de desenvolvedor ou as IAM funções apropriadas à conta do seu projeto. Durante ou depois de concluir as etapas de criação do projeto, você pode configurar suas permissões de blueprint escolhendo ou criando IAM funções em uma Conta da AWS que esteja conectada ao espaço.

Adicionar recursos e tarefas aos projetos criados

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