Guia de início rápido sobre como automatizar implantações do App Engine com o Cloud Build

Este tópico descreve como implantar automaticamente um aplicativo armazenado do Cloud Source Repositories no App Engine quando houver um novo commit.

Antes de começar

  1. Conclua as etapas em Guia de início rápido para criar um repositório.

    Depois de concluir o guia de início rápido, você terá um aplicativo que poderá ser implantado no App Engine.

  2. Ative as seguintes APIs:

Conceder ao App Engine acesso à conta de serviço do Cloud Build

O Cloud Build usa uma conta de serviço para implantar seu código. As permissões padrão para essa conta não permitem determinadas ações, como a implantação no App Engine.

É possível permitir que a conta de serviço seja implantada no Google App Engine concedendo os papéis do IAM adicionais à conta de serviço do Cloud Build.

Para conceder acesso ao Google App Engine à conta de serviço Cloud Build:

  1. Abra a página "IAM" no console

    Abra a página "IAM"

  2. Selecione o projeto e clique em Continuar.

  3. Na lista de membros, procure sua conta de serviço do Cloud Build chamada [PROJECT_NUMBER]@cloudbuild.gserviceaccount.com, em que [PROJECT_NUMBER] é o número do projeto do GCP.

  4. Clique no ícone de lápis nessa linha.

  5. Clique em Adicionar outro papel.

  6. No menu suspenso Selecionar um papel, selecione App Engine e, em seguida, selecione Administrador do App Engine.

  7. Clique em Salvar.

Implantar o aplicativo

  1. Em uma janela de terminal, navegue até o diretório que contém o repositório.

    cd hello-world
    
  2. Implante o aplicativo de amostra.

    gcloud app deploy app.yaml
    
  3. Verifique se o aplicativo está sendo executado.

    gcloud app browse
    

    A seguinte mensagem aparecerá na janela do navegador:

    Hello world!
    

Criar um arquivo cloudbuild.yaml

  1. Em uma janela de terminal, navegue até o diretório que contém o repositório.

    cd hello-world
    
  2. Usando um editor de texto, crie um arquivo chamado cloudbuild.yaml e cole o texto a seguir:

    steps:
    - name: "gcr.io/cloud-builders/gcloud"
      args: ["app", "deploy"]
    timeout: "1600s"
    

Adicionar o arquivo cloudbuild.yaml ao seu repositório

  1. Adicione o arquivo ao repositório.

    git add .
    
  2. Execute commit no arquivo.

    git commit -m "Add cloudbuild.yaml file"
    
  3. Adicione o conteúdo do repositório Git local ao Cloud Source Repositories usando o comando git push:

    git push origin master
    

Criar um acionador de versão

  1. Abra a página do Cloud Build no Console do Google Cloud Platform.

    Abra a página do Cloud Build

  2. Selecione o projeto e clique em Abrir.

  3. Clique em Criar acionador.

  4. Selecione Cloud Source Repository.

  5. Na lista de repositórios disponíveis, selecione o repositório hello-world e clique em Continuar.

  6. Na caixa Nome, digite:

    App Engine Test
    
  7. Em Tipo de acionador, selecione Branch.

  8. Em Configuração da versão, selecione cloudbuild.yaml.

  9. Na caixa Local do cloudbuild.yaml, digite:

    /cloudbuild.yaml
    
  10. Clique em Criar acionador.

Enviar uma alteração para seu aplicativo

  1. Em uma janela de terminal, use um editor de texto para atualizar o arquivo main.py da seguinte maneira:

    #!/usr/bin/env python
    
    import webapp2
    
    class MainHandler(webapp2.RequestHandler):
        def get(self):
    self.response.write('I update automatically!')
    
    app = webapp2.WSGIApplication([
        ('/', MainHandler)
    ], debug=True)
    
  2. Adicione o arquivo ao Git.

    git add .
    
  3. Execute commit no arquivo.

    git commit -m "Update app to demonstrate build triggers"
    
  4. Adicione o conteúdo do repositório Git local ao Cloud Source Repositories usando o comando git push:

    git push origin master
    

Visualizar sua versão em andamento

  1. Abra a página “Acionadores de versão” no Console do Google Cloud Platform.

    Abra a página “Acionadores de versão”

  2. Selecione o projeto e clique em Abrir.

  3. Na barra de navegação à esquerda, clique em Histórico da versão.

Será aberta uma lista de todas as versões. Na parte superior, há uma nova entrada que representa a versão iniciada depois que alteração foi enviada para o Cloud Source Repositories. Quando a versão estiver pronta, aparecerá uma marca de seleção verde ao lado da entrada de versão.

Testar novamente o aplicativo

Em uma janela de terminal, abra seu aplicativo:

gcloud app browse

O texto a seguir aparecerá na janela do navegador:

I update automatically!

Limpar

Para evitar cobranças na sua conta do GCP pelo uso de recursos neste guia de início rápido:

Excluir o acionador de versão

  1. Abra a página “Acionadores de versão” no Console do Google Cloud Platform.

    Abra a página “Acionadores de versão”

  2. Selecione o projeto e clique em Abrir.

  3. Localize o acionador criado.

  4. Clique no botão Mais Botão "Mais" ao lado do acionador que você quer excluir.

  5. Selecione Excluir.

Excluir o repositório

  1. Abra a visualização Todos os Repositórios do Cloud Source Repositories:

    Abrir Cloud Source Repositories

  2. Passe o cursor sobre o repositório e clique no botão de engrenagem.

    A tela “Configurações gerais” será aberta.

  3. Clique em Excluir este repositório.

    A tela “Remover repositório” será aberta.

  4. Digite o nome do repositório que você quer excluir.

  5. Clique em Excluir.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Source Repositories