Tutorial: começo com um projeto vazio e adição manual de recursos
Você pode criar um projeto vazio sem nenhum recurso predefinido dentro dele escolhendo o esquema 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 projeto. Como os projetos criados sem um esquema ficam vazios na criação, essa opção requer mais conhecimento sobre como criar e configurar recursos do CodeCatalyst para começar.
Tópicos
Pré-requisitos
Para criar um projeto vazio, você deve ter o perfil de Administrador do espaço ou Usuário avançado. Se esta for a primeira vez que você está se conectando ao CodeCatalyst, consulte Configuração e login no CodeCatalyst.
Criar 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
-
Navegue até o espaço onde você deseja criar um projeto.
-
No painel do espaço, escolha Criar projeto.
-
Escolha Começar do zero.
-
Em Dê um nome ao projeto, insira o nome que você deseja atribuir ao projeto. O nome deve ser exclusivo em seu espaço.
-
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 projeto. Os membros do projeto podem clonar esse repositório nos 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 será abordado neste tutorial. Para ter mais informações, consulte Vincular um repositório de origem.
Como criar um repositório de origem
Abra o console do CodeCatalyst em https://codecatalyst.aws/
. -
Navegue até o projeto.
-
No painel de navegação, selecione Código e, depois, selecione Repositórios de origem.
-
Escolha Adicionar repositório e selecione Criar repositório.
-
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 ter mais informações sobre os requisitos para nomes de repositórios, consulte Cotas para repositórios de origem no CodeCatalyst. -
(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.
-
Selecione 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.
-
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 principal para a ramificação padrão.
-
(Opcional) Adicione um arquivo
.gitignorepara o tipo de código que você planeja enviar. -
Escolha Criar.
nota
O CodeCatalyst adiciona um arquivo
README.mdao seu repositório quando você o cria. O CodeCatalyst também cria uma confirmação inicial para o repositório em uma ramificação padrão chamada principal. 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 repositório criando um Ambiente de Desenvolvimento. Para este tutorial, recomendamos que você crie um Ambiente de Desenvolvimento usando o 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 nessa ramificação, mas você pode inserir um nome de ramificação diferente, se preferir.
Como criar um Ambiente de Desenvolvimento com uma nova ramificação
Abra o console do CodeCatalyst em https://codecatalyst.aws/
. Navegue até o projeto em que deseja criar um Ambiente de Desenvolvimento.
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.
Na página inicial do repositório, selecione Criar um ambiente de desenvolvimento.
Selecione um IDE compatível no menu suspenso. Consulte Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento Para mais informações.
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.
Opcionalmente, adicione um alias para o Ambiente de Desenvolvimento.
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.
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.
Criar um fluxo de trabalho para criar, testar e implantar uma alteração de código
No CodeCatalyst, você organiza a criação, o teste e a implantação de aplicações 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 solicitação pull. Para obter mais informações sobre fluxos de trabalho, consulte Compilação, teste e implantação com fluxos de trabalho.
Siga as instruções descritas em Conceitos básicos de fluxos de trabalho para criar seu primeiro fluxo de trabalho.
Convidar alguém para o projeto
Agora que você configurou seu projeto personalizado, convide outras pessoas para trabalhar com você.
Para convidar alguém para o projeto
-
Navegue até o projeto para o qual você deseja convidar usuários.
-
No painel de navegação, escolha Configurações do projeto.
-
Na guia Membros, selecione Convidar.
-
Digite os endereços de e-mail das pessoas que você deseja convidar como usuários para o projeto. Você pode digitar vários endereços de e-mail separados por um espaço ou uma vírgula. Você também pode escolher entre membros do seu espaço que não sejam membros do projeto.
Escolha o perfil do usuário.
Ao concluir a adição de usuários, selecione Convidar.
Criar problemas para colaborar e monitorar o trabalho
O CodeCatalyst ajuda você a rastrear recursos, tarefas, bugs e qualquer outro trabalho envolvido no projeto com problemas. Você pode criar problemas para monitorar as ideias e o trabalho necessários. Por padrão, quando você cria um problema, ele é adicionado ao backlog. Você pode mover os problemas para um quadro onde é possível acompanhar 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
-
Abra o console do CodeCatalyst 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, selecione Amazon CodeCatalyst e, se necessário, selecione Visualizar todos os projetos. Escolha o projeto em que deseja criar ou trabalhar com os problemas.
-
No painel de navegação, selecione Rastrear e, depois, selecione Backlog.
-
Selecione Criar problema.
-
Em Título do problema, forneça um nome para o problema. Se desejar, 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 na lista de membros do projeto.
dica
Você pode optar por atribuir um problema ao Amazon Q para que o Amazon Q tente resolver o problema. Se a tentativa for bem-sucedida, uma solicitação pull 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: Usar os recursos de IA generativa do CodeCatalyst para acelerar seu trabalho de desenvolvimento.
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.
-
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 Acompanhar e organizar o trabalho com problemas no CodeCatalyst.
