Tutorial: começar com um projeto vazio e adicionar recursos manualmente

Você pode criar um projeto vazio sem nenhum recurso predefinido dentro dele escolhendo o blueprint do projeto vazio ao criar o projeto. Depois de criar um projeto vazio, você pode criar e adicionar recursos a ele de acordo com as necessidades do seu projeto. Como os projetos criados sem um blueprint ficam vazios na criação, essa opção exige mais conhecimento sobre criação e configuração de CodeCatalyst recursos para começar.

Pré-requisitos

Para criar um projeto vazio, você deve ter a função de administrador do espaço ou usuário avançado atribuída a você. Se esta é a primeira vez que você faz login CodeCatalyst, consulteConfigure e faça login em CodeCatalyst.

Crie um projeto vazio

Criar um projeto é o primeiro passo para poder trabalhar em conjunto. Se quiser criar seus próprios recursos, como repositórios de origem e fluxos de trabalho, você pode começar com um projeto vazio.

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.

Agora que você tem um projeto vazio, a próxima etapa é criar um repositório de origem.

Criar um repositório de origem

Crie um repositório de origem para armazenar e colaborar no código do seu projeto. Os membros do projeto podem clonar esse repositório em seus computadores locais para trabalhar no código. Como alternativa, você pode optar por vincular um repositório hospedado em um serviço compatível, mas isso não é abordado neste tutorial. Para ter mais informações, consulte Vinculando um repositório de origem.

Como criar um repositório de origem

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

2. Navegue até o seu projeto.

3. No painel de navegação, selecione Código e, em seguida, selecione Repositórios de origem.

4. Escolha Adicionar repositório e selecione Criar repositório.

5. Em Nomes de repositórios, forneça um nome para o repositório. Neste guia, usamos codecatalyst-source-repository, mas você pode escolher um nome diferente. Os nomes dos repositórios devem ser exclusivos em um projeto. Para obter mais informações sobre os requisitos para nomes de repositórios, consulteCotas para repositórios de origem em CodeCatalyst.

6. (Opcional) Em Descrição, adicione uma descrição para o repositório que ajudará outros usuários no projeto a entender para que o repositório é usado.

7. Escolha Criar repositório (padrão). Essa opção cria um repositório que inclui uma ramificação padrão e um arquivo README.md. Ao contrário de um repositório vazio, você pode usar esse repositório assim que ele for criado.

8. Na ramificação padrão, deixe o nome como principal, a menos que você tenha um motivo para escolher um nome diferente. Todos os exemplos neste guia usam o nome main para a ramificação padrão.

9. (Opcional) Adicione um .gitignore arquivo para o tipo de código que você planeja enviar.

10. Escolha Criar.

    nota

    CodeCatalyst adiciona um README.md arquivo ao seu repositório quando você o cria. CodeCatalysttambém cria uma confirmação inicial para o repositório em uma ramificação padrão chamada main. Você pode editar ou excluir o arquivo README.md, mas não pode excluir a ramificação padrão.

Você pode adicionar código rapidamente ao seu repositório criando um ambiente de desenvolvimento. Para este tutorial, recomendamos que você crie um ambiente de desenvolvimento usando AWS Cloud9 e escolha a opção de criar uma ramificação a partir da ramificação principal ao criar o ambiente de desenvolvimento. Usamos o nome test dessa ramificação, mas você pode inserir um nome de ramificação diferente, se preferir.

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. Escolha o nome do repositório na lista de repositórios de origem do projeto. Como alternativa, no painel de navegação, escolha Código, escolha Repositórios de origem e escolha o repositório para o qual você deseja criar um ambiente de desenvolvimento.

4. Na página inicial do repositório, escolha Create Dev Environment.

5. Escolha um IDE compatível no menu suspenso. Consulte Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento Para 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.

Crie um fluxo de trabalho para criar, testar e implantar uma alteração de código

Em CodeCatalyst, você organiza a criação, o teste e a implantação de seus aplicativos ou serviços em fluxos de trabalho. Os fluxos de trabalho consistem em ações e podem ser configurados para serem executados automaticamente após a ocorrência de eventos específicos do repositório de origem, como envio de código ou abertura ou atualização de uma pull request. Para obter mais informações sobre fluxos de trabalho, consulte Crie, teste e implante com fluxos de trabalho.

Siga as instruções em Introdução aos fluxos de trabalho para criar seu primeiro fluxo de trabalho.

Convide alguém para seu projeto

Agora que você configurou seu projeto personalizado, convide outras pessoas para trabalhar com você.

Para convidar alguém para seu projeto

1. Navegue até o projeto para o qual você deseja convidar usuários.

2. No painel de navegação, escolha Configurações do projeto.

3. Na guia Membros, escolha Convidar.

4. Digite os endereços de e-mail das pessoas que você deseja convidar como usuários para o seu projeto. Você pode digitar vários endereços de e-mail separados por um espaço ou vírgula. Você também pode escolher entre membros do seu espaço que não sejam membros do projeto.

5. Escolha a função do usuário.

   Ao terminar de adicionar usuários, escolha Convidar.

Crie problemas para colaborar e monitorar o trabalho

CodeCatalyst ajuda você a monitorar recursos, tarefas, bugs e qualquer outro trabalho envolvido em seu projeto com problemas. Você pode criar problemas para monitorar o trabalho e as ideias necessárias. Por padrão, quando você cria um problema, ele é adicionado à sua lista de pendências. Você pode mover os problemas para um quadro onde você acompanha o trabalho em andamento. Você também pode atribuir um problema a um membro específico do projeto.

Para criar um problema para um projeto

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

   Verifique se você está navegando no projeto em que deseja criar problemas. Para visualizar todos os projetos, no painel de navegação, escolha Amazon e CodeCatalyst, se necessário, escolha Visualizar todos os projetos. Escolha o projeto em que você deseja criar ou trabalhar com problemas.

2. No painel de navegação, escolha Rastrear e, em seguida, escolha Backlog.

3. Escolha Criar problema.

4. Em Título da edição, forneça um nome para a edição. Opcionalmente, forneça uma descrição do problema. Escolha o status, a prioridade e a estimativa do problema, se desejar. Você também pode atribuir o problema a um membro do projeto a partir da lista de membros do projeto.

   dica

   Você pode escolher atribuir um problema ao Amazon Q para que o Amazon Q tente resolver o problema. Se a tentativa for bem-sucedida, uma pull request será criada e o status do problema mudará para Em análise para que você possa revisar e testar o código. Para ter mais informações, consulte Tutorial: Usando recursos CodeCatalyst generativos de IA para acelerar seu trabalho de desenvolvimento.

   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.

5. Escolha Salvar.

Depois de criar problemas, você pode atribuí-los aos membros do projeto, estimá-los e monitorá-los em um quadro Kanban. Para ter mais informações, consulte Acompanhe e organize o trabalho com problemas no CodeCatalyst.