Esta página foi traduzida pela API Cloud Translation.
Switch to English

Como desenvolver um serviço localmente

Como configurar o serviço para desenvolvimento

Para executar o serviço localmente, especifique sua configuração primeiro:

  1. Selecione Run on Cloud Run Emulator usando a paleta de comandos (acessível com Ctrl/Cmd+Shift+ P).
  2. Isso inicia a caixa de diálogo "Executar/Depurar" no Cloud Run Emulator, em que é possível definir 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 suas configurações preferidas, clique em Executar.
  2. Monitore o status da sua implantação na janela de saída.

    Depois disso, é possível visualizar o serviço em execução seguindo o URL exibido na janela de saída.

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

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

  4. Após a conclusão da sessão, outras opções de menu contextual estarão disponíveis para monitorar o aplicativo e os recursos dele por meio da 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
    • Abrir o URL do serviço: abre o URL do serviço de aplicativo de um serviço específico em um navegador da Web.
    • Ativar/desativar o modo de exibição: alternar o modo de exibição para a sessão atual (não disponível para sessões de depuração).

      Opções disponíveis na barra de status do Cloud Code: abrir registros de implantação, abrir o URL do serviço e o modo de exibição, além das ações normais do Cloud Code.

  5. Para interromper a implantação, clique no botão Interromper na barra de ação 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. O Cloud Code permite armazenar esses secrets com segurança no Gerenciador de secrets e buscá-los de maneira programática quando precisar deles. Para uma visão detalhada de como criar e gerenciar secrets com o Cloud Code, consulte o guia do Gerenciador de secrets.

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: observa as alterações no espaço de trabalho quando está no modo de execução e executa o serviço novamente. 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.