Pré-requisitos¶

Prepare-se antes do workshop

Para garantir uma experiência sem problemas no workshop, complete os itens da lista de verificação na ordem.

Configure uma conta GitHub¶

Faça login na sua conta GitHub.

Você pode criar uma nova conta GitHub, se ainda não tiver uma. (1)

Clicar no botão abaixo abrirá a página em uma nova aba, para você criar uma nova conta GitHub. Mantenha seu @handle (nome de usuário) à mão depois de fazer login.

Criar uma nova conta GitHub

Clone o projeto do workshop para sua própria conta¶

Criar projeto do workshop
Na nova aba, a maioria dos campos será preenchida automaticamente e as configurações padrão devem estar corretas. Caso contrário...
- Para proprietário, escolha sua conta pessoal.
- Recomendamos criar um repositório público. (1)
  1. Repositórios públicos se beneficiam de
    - Uso gratuito dos minutos do GitHub Actions.
    - Uso gratuito dos recursos do GitHub Advanced Security.
- Role para baixo e clique no botão Create repository na parte inferior do formulário.
  
  Expanda para visualizar exemplo...
Depois que a criação do seu novo repositório começar, aguarde cerca de 20 segundos e depois atualize a página.

Habilitar Discussões¶

No GitHub.com, navegue até a página principal do seu novo repositório.
Abaixo do nome do repositório, clique em Settings.
Role para baixo até a seção "Set up discussions" e clique em Set up Discussions

Configurar segurança básica¶

Navegue até a aba Configurações no seu novo repositório do workshop.
Na seção "Segurança" do menu, selecione Advanced Security. Em seguida, configure as configurações para corresponder conforme a seguir (clicando em Enable onde a opção estiver/se tornar disponível).
Guia para configurações adicionais...
- Atualizações de versão do Dependabot
  
  Ao habilitar, você será solicitado a editar o arquivo de configuração .github/dependabot.yml. Simplesmente navegue de volta no seu navegador ou clique em Cancelar alterações para sair do prompt e continuar a configuração de segurança básica.
- Análise CodeQL
  1. A partir de Configurar, selecione a opção Padrão.
  2. Deixe as configurações padrão no prompt que segue e simplesmente clique em Habilitar CodeQL para continuar.
- Regras de proteção
  
  Selecione a configuração conforme mostrado abaixo.

Registrar um aplicativo GitHub¶

No canto superior direito de qualquer página no GitHub, clique na sua foto de perfil.
Navegue até as suas Settings da conta.
Na barra lateral esquerda, clique em Developer settings.
Na barra lateral esquerda, clique em GitHub Apps

Clique em Novo aplicativo GitHub

Forneça os valores dos campos do formulário da seguinte forma

GitHub App name..: <SEU-HANDLE>-bot

Homepage URL......: https://github.com/<SEU-HANDLE>/github-devsecops-fundamentals

Webhook
  Active...................: DESMARCAR

Permissões do repositório
  Actions...............: Read and write
  Administration........: Read and write
  Contents..............: Read and write
  Deployments...........: Read and write
  Discussions...........: Read and write
  Environments..........: Read and write
  Pages.................: Read and write

Onde este aplicativo GitHub pode ser instalado?
  Any account .................: SELECIONAR

Gere uma chave privada para o novo aplicativo GitHub conforme documentado em aqui.
Salve a chave privada do aplicativo GitHub nos segredos do seu novo repositório com o nome APP_PRIVATE_KEY_ACTIONS_ASSISTANT.

👀 Criando segredos para um repositório.
Salve o appid do aplicativo GitHub nas variáveis do seu novo repositório com o nome APP_ID_ACTIONS_ASSISTANT.

👀 Criando variáveis de configuração para um repositório
Acesse https://github.com/apps/<SEU-HANDLE>-bot. Instale o aplicativo no repositório que você criou anteriormente.
Expanda para guia adicional e visualizações de exemplo...

Para que serve um aplicativo GitHub?

Quando você usa o GITHUB_TOKEN do repositório para realizar tarefas, os eventos acionados pelo GITHUB_TOKEN, com exceção de workflow_dispatch e repository_dispatch, não criarão uma nova execução de fluxo de trabalho. Isso evita que você crie acidentalmente execuções de fluxo de trabalho recursivas. Por exemplo, se uma execução de fluxo de trabalho envia código usando o GITHUB_TOKEN do repositório, um novo fluxo de trabalho não será executado mesmo quando o repositório contiver um fluxo de trabalho configurado para ser executado quando ocorrerem eventos de push.

Se você quiser acionar um fluxo de trabalho a partir de uma execução de fluxo de trabalho, poderá usar um token de acesso de instalação do aplicativo GitHub ou um token de acesso pessoal em vez do GITHUB_TOKEN para acionar eventos que exigem um token.

Se você usar um aplicativo GitHub, precisará criar um aplicativo GitHub e armazenar o ID do aplicativo e a chave privada como segredos.

~ Acionando um fluxo de trabalho a partir de um fluxo de trabalho

Durante os exercícios do workshop, você descobrirá como o aplicativo GitHub é usado para acionar a implantação automática de artefatos de lançamento.

Criar um quadro de projeto para o repositório¶

Abra o repositório do workshop recém-criado.
Navegue até a guia Projects.
Clique no botão New Project para iniciar o assistente de criação de projeto.
Selecione o modelo Kanban.
Dê um nome ao projeto
Finalmente, clique no botão Create project.

Provisionar um novo ambiente de desenvolvimento em nuvem para o workshop¶

O GitHub Codespaces permite que você comece a codificar instantaneamente no projeto do workshop. Contas pessoais no GitHub podem se beneficiar de uma cota gratuita de uso do GitHub Codespaces.

Navegue até a guia Código.
Abra o menu Code e clique em Create codespaces on main.

Expanda para visualização de exemplo...
Deixe o ambiente de desenvolvimento Codespace inicializar e ser executado, voltaremos a usá-lo mais tarde.