Instalar o plug-in do Cloud Code for IntelliJ

O plug-in do Cloud Code para IntelliJ adiciona compatibilidade com o desenvolvimento do Google Cloud à família de ambientes de desenvolvimento integrado da JetBrains, incluindo IntelliJ (edições Community e Ultimate), GoLand, PyCharm, WebStorm e outros.

Pré-requisitos

As seguintes ferramentas serão instaladas e configuradas no sistema e estarão disponíveis no PATH da sua máquina:

  • Ambiente de desenvolvimento integrado JetBrains versão 2022.3 ou mais recente

    É necessário que o ambiente de desenvolvimento integrado seja algum desses da JetBrains:

    • IntelliJ Ultimate ou Community
    • PyCharm Professional ou Community
    • WebStorm
    • GoLand
  • Git para que o Cloud Code possa realizar operações do Git, como clonar uma amostra.

  • Docker para criar e enviar as imagens de contêiner.

  • Cluster configurado do Kubernetes, que pode ser um cluster para desenvolvimento local, como o Minikube (em inglês) ou o Docker Kubernetes, ou um cluster remoto, como o cluster do Google Kubernetes Engine. Recomenda-se um cluster minikube para desenvolvimento local. o minikube pode ser gerenciado automaticamente pelo Cloud Code.

  • Projeto do Google Cloud com faturamento ativado se você estiver usando o Google Cloud. Com os projetos, é possível coletar todos os recursos relacionados a um único aplicativo em um só lugar, além de gerenciar APIs, ativar serviços do Google Cloud, adicionar e remover colaboradores e gerenciar permissões para recursos do Google Cloud.

Instalar o plug-in do Cloud Code

Instale o plug-in do Cloud Code (em inglês) do JetBrains Marketplace.

Como alternativa, instale o plug-in diretamente do seu ambiente de desenvolvimento integrado:

  1. Inicie o ambiente de desenvolvimento integrado.

  2. Abra o mercado de plug-ins do ambiente de desenvolvimento integrado:

    • No Windows, acesse File > Settings > Plugins.
    • No macOS, acesse IntelliJ IDEA > Preferences > Plugins.
  3. Digite Google Cloud Code no campo de pesquisa e instale o plug-in do Cloud Code.

    Plug-in do Cloud Code no IntelliJ Marketplace

  4. Se solicitado, reinicie o ambiente de desenvolvimento integrado para ativar o plug-in.

Dependências gerenciadas

Por padrão, o Cloud Code instala algumas dependências de linha de comando necessárias automaticamente, como:

  • kubectl para trabalhar com clusters e gerenciar implantações do Kubernetes.
  • Skaffold para dar suporte ao desenvolvimento contínuo em um cluster do Kubernetes, à criação e inclusão de tags inteligente de imagens e a uma matriz de tipos de build e implantação compatíveis.
  • minikube para compatibilidade com o desenvolvimento local.
  • CLI gcloud para dar suporte ao gerenciamento de recursos no Google Cloud.

Versões personalizadas de dependências

Para usar versões personalizadas de dependências, desative o gerenciamento de dependências da seguinte maneira:

  1. Especifique as configurações relevantes do Cloud Code no seu ambiente de desenvolvimento integrado abrindo File > Settings > Tools > Cloud Code. > Dependencies ou, no Mac OS X, IntelliJ IDEA > Preferences > Tools > Cloud Code > Dependências e configuração da seção Ferramentas de implantação.

  2. Instale as dependências relevantes no seu PATH:

Opcional: fazer o download e verificar o binário do Cloud Code

Verificar o binário do Cloud Code ajuda a garantir que o plug-in do Cloud Code não foi adulterado no decorrer do pipeline de publicação e entrega.

Para fazer o download do binário Stable ou Insiders do Cloud Code na sua máquina, siga estas etapas:

  1. Na página Versões do plug-in do Cloud Code, selecione o canal Stable ou Insiders.

    Para mais informações sobre o build do Insiders, consulte Usar recursos de pré-lançamento.

  2. Faça o download da versão mais recente do Cloud Code ou de uma que você queira verificar e que se enquadre nas versões atuais compatíveis com a verificação:

    • Stable: todas as versões depois de 23.1.1-221/23.1.1-222 (23.1.1-221/23.1.1-222 não incluídas)

    • Pessoas privilegiadas: todos os lançamentos após 23.1.1-221-IB.1/23.1.1-222-IB.1 (23.1.1-221-IB.1/23.1.1-222-IB.1 não incluídos)

  3. Anote o caminho para seu binário do Cloud Code (o arquivo google-cloud-code.zip).

Para verificar o binário do Cloud Code, siga estas etapas:

  1. Faça o download da versão mais recente do arquivo marketplace-zip-signer-cli.jar para sua máquina. Anote o caminho para o arquivo jar.

  2. Faça o download do DigiCert Trusted Root G4. Anote o caminho para o arquivo do certificado.

  3. Verifique se o JDK está instalado. Isso é necessário para executar comandos Java.

  4. Para verificar o arquivo zip (o binário do Cloud Code), execute o seguinte na linha de comando:

    java -jar PATH_TO_ZIP_SIGNER_JAR verify -in PATH_TO_ZIP_FILE -cert PATH_TO_CERTIFICATE_FILE
    

    Se a verificação falhar, uma das seguintes mensagens aparecerá na saída da linha de comando:

    • Zip archive is not signed by provided certificate authority.
    • Provided zip archive is not signed.
    • Signature of zip archive is invalid.

    Se você não vir uma mensagem na saída da linha de comando, a verificação foi bem-sucedida.

Receba ajuda

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.