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:
- Abra a paleta de comandos (pressione
Ctrl/Cmd+Shift+P) e execute o comando Run on Cloud Run Emulator. Na caixa de diálogo "Run/Debug on Cloud Run Emulator", defina as especificações da sua configuração.
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
- Depois de definir as configurações preferenciais, execute o serviço clicando em Run.
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.
Para ver registros detalhados, alterne para a visualização detalhada do Cloud Run na janela de saída.
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.
Para interromper a implantação, clique no botão Parar na barra de ações da implantação atual.
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.