Instalar o plug-in do Cloud Code para IntelliJ

O plug-in do Cloud Code para IntelliJ adiciona compatibilidade com o desenvolvimento em 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 posterior

    É 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.

  • Google Cloud projeto com faturamento ativado se você estiver usando 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 doGoogle Cloud .

Instalar o plug-in do Cloud Code

Instale o plug-in do Cloud Code no JetBrains Marketplace.

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

  1. Inicie o ambiente de desenvolvimento integrado.

  2. Abra o mercado de plug-ins da sua IDE:

    • No Windows, acesse File > Settings > Plugins.
    • No macOS, navegue até IntelliJ IDEA > Preferências > Plug-ins.

  3. Digite Google Cloud Code no campo de pesquisa e instale o plug-in do Cloud Code.

    Plug-in do Cloud Code no marketplace do IntelliJ

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

  5. Para evitar conflitos se você estiver usando o Android Studio como ambiente de desenvolvimento integrado, desative o plug-in Google Cloud Tools for Android Studio depois de instalar o Cloud Code. O plug-in Google Cloud Tools for Android Studio será descontinuado em breve e removido completamente em uma versão futura do Android Studio.

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 gerenciar 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: faça o download e verifique o binário do Cloud Code

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

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

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

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

  2. Faça o download da versão mais recente do Cloud Code ou de uma versão que você quer verificar e que se enquadra nas versões atuais que oferecem suporte à verificação:

    • Estável: todas as versões após 23.1.1-221/23.1.1-222 (23.1.1-221/23.1.1-222 não incluído)

    • Insiders: todas as versões 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ído)

  3. Anote o caminho para o 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 do arquivo jar.

  2. Faça o download da DigiCert Trusted Root G4. Anote o caminho para o arquivo de 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 vai 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 nenhuma mensagem aparecer na saída da linha de comando, a verificação foi concluída.

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.