Instalar o plug-in do Cloud Code para IntelliJ

O plug-in do Cloud Code para IntelliJ adiciona suporte ao 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 precisam ser instaladas e configuradas no sistema e estar disponíveis no PATH da sua máquina:

  • Ambiente de desenvolvimento integrado da 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 um exemplo.

  • 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 project 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 Google Cloud, adicionar e remover colaboradores e gerenciar permissões de recursosGoogle Cloud .

Instalar o plug-in do Cloud Code

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

Como alternativa, você pode instalar o plug-in diretamente no seu ambiente de desenvolvimento integrado:

  1. Inicie o ambiente de desenvolvimento integrado.

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

    • No Windows, navegue até File > Settings > Plugins.
    • No macOS, navegue até 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 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 após instalar o Cloud Code. O plug-in Google Cloud Tools for Android Studio será descontinuado em breve e removido por completo 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 dar suporte a recursos de gerenciamento 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

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 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 para participantes do Programa para desenvolvedores, 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 que esteja entre as versões atuais com 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ídas)

    • Usuários avançados: 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ídas)

  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 não houver uma mensagem na saída da linha de comando, a verificação será bem-sucedida.

Receber suporte

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Help / About > Submit feedback or report an issue para informar um problema no GitHub.