Como desenvolver um serviço do Cloud Run localmente

Antes de implantar um serviço no Cloud Run, você pode desenvolvê-lo localmente usando um emulador do Cloud Run.

Como configurar o serviço para desenvolvimento

Para executar o serviço localmente, especifique a configuração da seguinte maneira:

  1. Abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P) e execute o comando Run on Cloud Run Emulator.
  2. Na caixa de diálogo "Run/Debug on Cloud Run Emulator", defina as especificações da sua configuração.

    Cloud Run: execução/depuração da IU local

Opcional: como personalizar sua configuração

Além das configurações acima, é possível especificar configurações avançadas, como uma conta de serviço e variáveis de ambiente, usando a seção "Configurações avançadas".

Variáveis de ambiente

As variáveis de ambiente a seguir são adicionadas automaticamente aos contêineres em execução:

Nome Descrição Exemplo
PORTA A porta que o servidor HTTP deve detectar. 8080
K_SERVICE O nome do serviço do Cloud Run em execução. hello-world
K_REVISION O nome da revisão do Cloud Run em execução. hello-world.1
K_CONFIGURATION O nome da configuração do Cloud Run que criou a revisão. hello-world

Como executar o serviço localmente

  1. Depois de definir as configurações preferenciais, execute o serviço clicando em Run.
  2. Monitore o status da sua implantação na janela de saída.

    Após a conclusão da implantação, veja o serviço em execução abrindo o URL exibido na janela de saída.

  3. Para ver registros detalhados, alterne para a visualização detalhada do Cloud Run na janela de saída.

    Painel de saída com "hello-world-5 - Detalhado" selecionado na lista suspensa do canal de saída

  4. Após a conclusão da sessão, há mais opções de menu contextual disponíveis para monitorar seu aplicativo e os recursos dele usando a barra de status do Cloud Code, incluindo:

    • Abrir registros de implantação: abra os registros do aplicativo de uma implantação específica com o Visualizador de registros do Cloud Code
    • Open Service URL: abra o URL do serviço do aplicativo de um serviço específico em um navegador da Web.
    • Ativar/desativar o modo de exibição:alterne o modo de exibição da sessão atual. Por padrão, o Cloud Code monitora continuamente o sistema de arquivos em busca de alterações nos arquivos, como a configuração ou o código do Kubernetes, recria os contêineres e reimplanta o aplicativo no cluster para que o{ 101}as edições são refletidas quase em tempo real.
  5. Para interromper a implantação, clique no botão Parar na barra de ações da implantação atual.

    Barra de ações para implantação do Cloud Run

Como armazenar chaves secretas

Se o código inclui dados possivelmente confidenciais, como chaves de API, senhas e certificados, é recomendável armazená-los como secrets. Com o Cloud Code, é possível armazenar esses secrets com segurança no Gerenciador de secrets e buscá-los de maneira programática quando necessário. Para uma visão detalhada de como criar e gerenciar secrets com o Cloud Code, consulte o Guia do Secret Manager.

Como personalizar uma configuração launch.json

Para configurar a execução do serviço, personalize o skaffold.yaml e especifique os seguintes campos em .vscode/launch.json:

  • watch: detecta alterações no espaço de trabalho quando está no modo de execução e executa novamente o serviço. A menos que seja explicitamente definido como falso, verdadeiro por padrão.
  • build: especifique o construtor (Docker, buildpacks) para desenvolver as imagens.
  • image: especifique o nome da imagem que você quer usar.
  • service: especifique o serviço do Cloud Run que você quer usar.
  • debug: especifica as configurações de depuração preferidas, como o mapeamento de caminho remoto, para mapear um caminho local para um caminho no contêiner remoto.

Como receber suporte

Acesse o GitHub para enviar feedback e informar problemas ou o Stack Overflow (ambos em inglês) para fazer perguntas.