Desenvolver um serviço do Cloud Run localmente no Cloud Code para VS Code

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

Se você não tiver um arquivo .vscode/launch.json definido, a caixa de diálogo Run/Debug on Cloud Run Emulator vai permitir que você configure a inicialização e salve as configurações em .vscode/launch.json. Se você tiver um arquivo .vscode/launch.json configurado, poderá editá-lo diretamente.

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

Abra a paleta de comandos (pressione Ctrl/Cmd + Shift + P ou clique em Visualizar > Paleta de comandos) e execute o comando Executar no emulador do Cloud Run.

Na caixa de diálogo "Run/Debug no Cloud Run Emulator", defina as especificações para sua configuração:

Somente ferramentas de build instaladas localmente estão disponíveis para o emulador do Cloud Run
Escolha Docker ou Buildpacks como seu builder e, em seguida, especifique a origem.

(Opcional) Para especificar qualquer variável de ambiente que será transmitida para os contêineres em execução, expanda Configurações avançadas de build e clique para especificar pares de chave-valor.

Nome	Descrição	Exemplo
PORT	A porta do servidor HTTP para 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

Opcional: para especificar conexões do Cloud SQL, expanda as Configurações de serviço avançadas, clique em Conexões e especifique uma conexão do Cloud SQL por linha.
(Opcional) Marque a opção Tornar o serviço acessível de outros dispositivos na rede local.
Opcional: se você quiser recriar e executar o serviço manualmente, em vez de fazer isso automaticamente ao fazer uma alteração, desmarque a opção Recriar e executar novamente de forma automática.

Como executar o serviço localmente

Depois de definir as configurações preferenciais, execute o serviço clicando em Run.
Se solicitado, autentique suas credenciais para executar e depurar um aplicativo localmente.
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.
Depois que a sessão for concluída, clique com o botão direito do mouse para usar os seguintes comandos:
- Ver registros:abra os registros do aplicativo de uma implantação específica com a Análise de registros do Cloud Code.
- Abrir URL:abra o URL do serviço de aplicativo de um serviço específico em um navegador da Web.
Se você tiver desativado o modo de observação na configuração de inicialização e quiser fazer alterações no aplicativo para recriar e reimplantá-lo, clique na barra de status do Cloud Code e em Ativar modo de observação.
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 incluir dados potencialmente confidenciais, como chaves de API, senhas e certificados, armazene-os como secrets para protegê-los. A integração do Secret Manager do Cloud Code permite armazenar esses secrets com segurança e buscá-los de maneira programática. 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

O plug-in do Cloud Code atualiza o arquivo de configuração launch.json automaticamente quando você escolhe uma ação de execução. Para personalizar ainda mais a execução do serviço, especifique os campos a seguir no arquivo .vscode/launch.json:

watch: monitora as alterações no espaço de trabalho e executa o serviço novamente. "True" por padrão.

O exemplo abaixo mostra o relógio definido como true:
```
"watch": true,
```
build: especifique o builder (Docker, jib Maven, jibGradle ou buildpacks) para criar as imagens.

O exemplo a seguir mostra um builder do Docker:
```
"build": {
  "docker": {
    "path": "Dockerfile"
  }
},
```
O exemplo a seguir mostra um builder de buildpack:
```
"build": {
  "buildpacks": {
    "path": "src/requirements.txt",
    "builder": "gcr.io/buildpacks/builder:v1"
  }
},
```
image: especifica o nome da imagem a ser usada.

O exemplo a seguir mostra como especificar um nome de imagem:
```
  "image": "hello-world",
```
service: especifique o serviço do Cloud Run a ser usado.

O exemplo a seguir mostra como especificar um nome de serviço, uma porta e limites de recursos:
```
"service": {
  "name": "hello-world",
  "containerPort": 8080,
  "resources": {
    "limits": {
      "memory": "256Mi"
    }
  }
},
```
debug: especificar configurações de depuração, como o mapeamento de caminho remoto, para mapear um caminho local para um caminho no contêiner remoto.

O exemplo a seguir mostra uma seção de depuração que indica a localização dos arquivos de origem:
```
"debug": {
  "sourceFileMap": {
    "${workspaceFolder}": "/app"
  }
}
```

Receber suporte

Para enviar feedback, informar problemas no GitHub ou fazer uma pergunta no Stack Overflow.