Guia de início rápido

Esta página mostra rapidamente os primeiros passos com o Cloud Code.

Você configurará um aplicativo Hello World que é executado no Cloud Run usando um modelo inicial, implantará seu aplicativo no Cloud Run e visualizará o status dos recursos ativos do aplicativo.

Antes de começar

Para usar o Cloud Run, é preciso criar um projeto do GCP e ativar o faturamento.

Como instalar o Cloud Code

  1. Instale o Visual Studio Code na sua máquina, caso ainda não tenha feito isso.
  2. Instale as dependências:
    • Para todas as plataformas do Cloud, verifique se o cliente do Docker (autenticado com o registro do Docker) está instalado no PATH da máquina (a respectiva pasta precisa estar visível em um diretório no PATH).
      • Para verificar se o Docker já está instalado, execute docker -v.
      • Se você estiver usando o Windows Home, consulte este guia sobre como configurar o cliente Docker.
      • Se você estiver usando o WSL, mas não puder instalar o Docker para computadores, use o minikube para desenvolvimento local com o Cloud Code.
    • O Cloud Code instalará automaticamente o kubectl, o Skaffold e o SDK do Google Cloud.
  3. Instale o Cloud Code usando uma destas opções:
    • Use este link para abrir o VS Code e instalar o Cloud Code.
    • Abra o Visual Studio Code na sua máquina. Usando a visualização "Extensões" Ícone de extensão no VS Code (ícone quadrado disponível na barra de tarefas à esquerda), procure a extensão "Cloud Code" e clique em "Instalar".
  4. Quando a instalação estiver concluída, você verá a página de boas-vindas do Cloud Code e uma coleção de modelos integrados em "Aplicativos para iniciantes", que podem ser usados para configurar rapidamente um novo aplicativo.

    Página de boas-vindas

Como criar um aplicativo

  1. Na barra de status do Cloud Code, selecione Novo aplicativo. Como criar um novo aplicativo com a barra de status do Cloud Code
  2. Selecione "Aplicativo do Cloud Run" como seu tipo de aplicativo preferido.
  3. Na lista de modelos [Node.js, Python (frameworks Flask e Django), Java, Go], escolha um aplicativo Hello World em uma linguagem de sua escolha.

    Por exemplo, escolher Node.js: Hello World criará um aplicativo Hello World para Node.js.

  4. Confirme o local do seu aplicativo (ou modifique-o, se necessário) para continuar.

    Uma notificação confirmará que seu aplicativo foi criado e uma nova janela será aberta.

Implantar para o Cloud Run

Para implantar o aplicativo no Cloud Run, siga estas etapas:

  1. Escolha o comando Cloud Run: implantar usando a barra de status do Cloud Code.

    Isso abre a IU do Cloud Run: implantar. Cloud Run: executar/depurar localmente a IU com o serviço pré-existente selecionado

  2. Defina seu projeto do Google Cloud.

  3. Selecione um serviço preexistente ou crie um novo.

  4. Se você estiver criando um novo serviço, selecione "Cloud Run (totalmente gerenciado)" em "Plataforma de implantação".

  5. Escolha uma região para implantar.

  6. Depois de definir suas configurações preferidas, clique em "Implantar".

    Em seguida, o Cloud Code cria sua imagem, envia para o registro e implanta o aplicativo no Cloud Run. Seu aplicativo agora está ao vivo.

  7. Veja seu aplicativo em execução seguindo o URL exibido na visualização da Web.

Como visualizar registros

Também é possível ver os registros do aplicativo implantado com o Visualizador de registros fornecido com o Cloud Code.

Para ver os registros, siga estas etapas:

  1. Navegue até o explorador do Cloud Run clicando no ícone na barra de atividades do VS Code à esquerda Ícone do explorador do Cloud Run.
  2. Clique com o botão direito do mouse no serviço do Cloud Run e selecione "Visualizar registros".

    Como visualizar registros de um cluster que não seja do Cloud Logging definindo o campo de implantação na caixa de pesquisa do Visualizador de registros como

Como visualizar o status do recurso

É possível ver o status dos serviços do Cloud Run usando o navegador de serviços do Cloud Run:

  1. Navegue até o explorador do Cloud Run clicando no ícone na barra de atividades do VS Code à esquerda Ícone do explorador do Cloud Run.
  2. Clique no serviço do Cloud Run que você quiser saber mais. Suas propriedades são exibidas na janela abaixo.

    Propriedades de um serviço selecionado exibido abaixo no explorador do Cloud Run

Como limpar

Para excluir seu projeto:

  • Acesse a página Projetos no Console do Cloud:

    Acesse a página Projetos

  • Selecione o projeto que você criou neste guia de início rápido e clique no ícone de lixeira ao lado para excluí-lo.

    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