Guia de início rápido: como implantar um serviço do Cloud Run com o Cloud Code

Veja nesta página como começar a usar o Cloud Code.

Você vai configurar um serviço Hello World que é executado no Cloud Run usando um aplicativo de amostra, implantar seu serviço no Cloud Run e visualizar o status dos recursos do serviço ativo.

Se você estiver executando este guia de início rápido no Apple Silly-Series, o aplicativo será criado com o Cloud Build, o que poderá gerar cobranças. Para mais informações, consulte Suporte do Cloud Code para o Silicon série Apple M.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Ative a API Cloud Run.

    Ative a API

  5. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  6. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  7. Ative a API Cloud Run.

    Ative a API

Como instalar o Cloud Code

Para instalar o plug-in do Cloud Code para IntelliJ:

  1. Instale o ambiente de desenvolvimento integrado do JetBrains versão 2020.3 ou mais recente (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand, caso ainda não tenha feito isso.

  2. Se você estiver executando o Cloud Code no Apple Silicon série {1/}, instalar Rosetta 2 de dados. Isso permite que o Cloud Code instale o kubectl como uma dependência gerenciada.

    Se você preferir não instalar o Rosetta 2, desative as dependências gerenciadas (IntelliJ IDEA > Preferences > Tools > }Cloud Code > Dependencies) e instale sua própria versão do ARM de kubectl conforme descrito em Versões personalizadas de dependências.

  3. Instale as dependências:

    • Para todas as plataformas do Cloud, verifique se o cliente Docker (autenticado com o registro do Docker) está instalado no PATH da máquina. A pasta precisa estar visível em um diretório no PATH. Para verificar se o Docker já está instalado, execute docker -v.
    • O Cloud Code instala automaticamente outras dependências necessárias.
  4. Abra o IntelliJ IDEA ou qualquer ambiente de desenvolvimento integrado compatível do JetBrains.

  5. Com seu ambiente de desenvolvimento integrado aberto, atualize esta página.

    Agora é possível instalar o plug-in do Cloud Code clicando diretamente no botão abaixo:

    O botão inicia uma caixa de diálogo de instalação no ambiente de desenvolvimento integrado aberto. Clique em OK para configurar o Cloud Code.

Como criar um serviço

Para criar um novo serviço usando uma amostra existente:

  1. No ambiente de desenvolvimento integrado, abra File > New Project e selecione Cloud Code: Cloud Run.
  2. Selecione a linguagem de programação do aplicativo de amostra e clique em Próxima. Como criar um serviço a partir de uma lista de aplicativos de amostra
  3. Atribua um nome ao projeto e clique em Finish.

    O Cloud Code clona o aplicativo de amostra, abre o projeto recém-criado para uso e cria as configurações de execução necessárias do Cloud Run.

  4. Se você escolheu um aplicativo de amostra em Java, quando solicitado, clique em Carregar projeto Maven.

    Notificação de scripts de criação do Maven encontrados - escolha Carregar projeto Maven, Pular ou Ajuda

Agora é possível executar o serviço Hello World. O Cloud Code monitora o sistema de arquivos em busca de alterações para que você possa editar e executar o serviço quase em tempo real.

Como implantar o serviço no Cloud Run

Para implantar o serviço, siga estas etapas:

  1. Escolha a configuração de execução criada automaticamente, Cloud Run: Deploy, no seletor de configurações de execução/depuração na barra de navegação.

    Se você estiver executando este guia de início rápido no Cloud Silicon, o aplicativo será criado com o Cloud Build. Para informações sobre os preços do Cloud Build, consulte Preços.

  2. Clique em Run Ícone do botão de execução. A janela "Editar configuração" será aberta.

  3. Defina o ID do projeto do Google Cloud.

  4. Escolha uma região para sua plataforma de implantação.

    Neste guia de início rápido, usamos a opção de plataforma padrão, Cloud Run (totalmente gerenciado), como a plataforma de implantação.

  5. Clique em Executar.

  6. Veja o serviço em execução seguindo o URL exibido na janela de saída.

  7. Também é possível visualizar o status do serviço (métricas, detalhes de revisão e muito mais) seguindo o URL de registros exibido na janela de saída.

    Como visualizar o status do serviço no Console do Cloud

Como visualizar o status do recurso

Para ver o status dos recursos do serviço em execução, siga estas etapas:

  1. Navegue até o Cloud Run Explorer. É possível acessá-lo no painel da barra lateral à direita.

    Guia do explorador do Cloud Run destacada no painel do lado direito

  2. Para exibir as propriedades de um serviço ou revisão, clique no serviço ou revisão no explorador.

    O Cloud Run Explorer aberto com um serviço selecionado e as propriedades dele exibidas abaixo

  3. Para ver os registros de uma revisão, clique com o botão direito na revisão e clique em Ver registros do Cloud.

    Clique com o botão direito em uma revisão para ver os registros.

Como fazer a limpeza

Se você criou um projeto para este guia de início rápido, exclua-o para evitar cobranças desnecessárias:

  1. Acesse a página "Projetos" no Console do Google Cloud:

    Acessar a página "Projetos"

  2. Selecione o projeto que você criou para este guia de início rápido e clique em Excluir.

    Isso encerrará o projeto e programará a remoção dele.

Se você estiver usando um projeto preexistente e quiser excluir os recursos criados para este guia de início rápido:

A seguir

Como receber suporte

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Help / About > Envie feedback ou informe um problema para informar um problema no GitHub ou faça uma pergunta no Stack Overflow.

Você também pode participar do canal #cloud-code, que faz parte da comunidade do Google Cloud no Slack.