Adicionar um blueprint em um projeto para integrar recursos

Você pode adicionar vários blueprints em um projeto para incorporar componentes funcionais, recursos e governança. Seus projetos podem suportar vários elementos que são gerenciados de forma independente em esquemas separados. Adicionar esquemas a um projeto reduz a necessidade de criar recursos manualmente e tornar os componentes de software funcionais. Seus projetos também podem se manter atualizados à medida que os requisitos evoluem. Para saber mais sobre como adicionar blueprints em seu projeto, consulteTrabalhando com o gerenciamento do ciclo de vida como usuário do blueprint.

Ao configurar os detalhes de um blueprint, você também pode optar por armazenar o código-fonte do blueprint em um repositório terceirizado preferido, onde você ainda pode gerenciar o blueprint e utilizar os recursos de gerenciamento do ciclo de vida para manter seu projeto atualizado. Para obter mais informações, consulte Adicione funcionalidade a projetos com extensões no CodeCatalyst e Trabalhando com o gerenciamento do ciclo de vida como usuário do blueprint.

Importante

Para adicionar um blueprint ao seu CodeCatalyst projeto, você deve estar conectado com uma conta que tenha a função de administrador do espaço, usuário avançado ou administrador do projeto no espaço.

dica

Depois de adicionar um blueprint ao seu projeto, você pode configurar suas notificações por e-mail e Slack para fornecer atualizações sobre as alterações mais recentes no blueprint. Para ter mais informações, consulte Enviando notificações de CodeCatalyst.

Para adicionar um blueprint ao seu projeto

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

2. No CodeCatalyst console, navegue até o espaço e escolha o projeto ao qual você deseja adicionar um blueprint.

3. No painel de navegação, escolha Blueprints e, em seguida, escolha Adicionar 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 obter 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. Escolha um blueprint na guia CodeCatalyst Blueprints ou um blueprint personalizado na guia Space blueprints e, em seguida, escolha Avançar.

5. Em Detalhes do blueprint, escolha uma versão do blueprint no menu suspenso Versão do Target. A versão mais recente do catálogo é selecionada automaticamente.

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 ter mais informações, consulte Adicione funcionalidade a projetos com extensões no CodeCatalyst.

   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 escolha a GitHub conta na qual você deseja armazenar o código-fonte criado pelo blueprint.

     nota

     Se você estiver usando uma conexão com uma GitHub conta, deverá criar uma conexão pessoal para estabelecer o mapeamento de identidade entre sua CodeCatalyst identidade e sua GitHub identidade. Para obter 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 Configurar blueprint, configure os parâmetros do blueprint. Dependendo do blueprint, você pode ter a opção de nomear o repositório de origem.

8. Analise as diferenças entre a versão atual do blueprint e sua versão atualizada. A diferença exibida em uma pull request mostra as alterações entre a versão atual e a versão mais recente, que é a versão desejada no momento em que a pull request foi criada. Se nenhuma alteração for exibida, as versões podem ser idênticas ou você pode ter escolhido a mesma versão para a versão atual e a versão desejada.

9. Quando você estiver convencido de que a pull request contém o código e as alterações que você deseja revisar, escolha Adicionar blueprint. Depois de criar a pull request, você pode adicionar comentários. Os comentários podem ser adicionados à pull request ou a linhas individuais em arquivos, bem como à pull request geral. Você pode adicionar links a recursos, como arquivos, usando o @ sinal seguido pelo nome do arquivo.

   nota

   O blueprint não será aplicado até que a pull request seja aprovada e mesclada. Para obter mais informações, consulte Analisando uma pull request e Mesclando uma pull request.

Os autores do blueprint também podem adicionar um blueprint personalizado a projetos em espaços específicos que não tenham o blueprint disponível para criar novos projetos ou adicionar a projetos existentes. Para ter mais informações, consulte Publicar e adicionar um blueprint personalizado em espaços e projetos específicos.

Se você não quiser mais receber atualizações para um blueprint, você pode desassociar o blueprint do seu projeto. Para ter mais informações, consulte Desassociar um blueprint de um projeto para interromper as atualizações.