Enterprise Distributed Application Service:Deploy an application to a Kubernetes cluster from IntelliJ IDEA

Pré-requisitos

Antes de começar, verifique se você tem:

• Java Development Kit (JDK) 1.8 ou superior

• IntelliJ IDEA 2018.3 ou superior

• Um aplicativo implantado em um cluster ACK. Para instruções de configuração, consulte Usar uma imagem para implantar um aplicativo de microsserviços Java em um cluster Kubernetes

• Um par de AccessKey (AccessKey ID e AccessKey secret) da sua conta Alibaba Cloud ou de um usuário do Resource Access Management (RAM) com permissões de implantação no EDAS

O servidor de plug-ins da JetBrains está localizado fora da China continental. Se não conseguir baixar o plug-in devido à lentidão da rede, entre no grupo do DingTalk indicado ao final deste tópico para obter o pacote de instalação offline com o suporte técnico do Alibaba Cloud Toolkit.

Se utilizar um usuário RAM, sincronize-o com o EDAS e autorize-o a implantar aplicativos. Consulte Autorizar um usuário RAM para o EDAS para obter as instruções de configuração.

Etapa 1: Instalar o Alibaba Cloud Toolkit

1. Abra o IntelliJ IDEA.

2. Acesse as configurações de plug-ins:

   • macOS: Selecione IntelliJ IDEA > Preferences > Plugins.

   • Windows: Selecione File > Settings > Plugins.

3. Na caixa de pesquisa, insira Alibaba Cloud Toolkit e clique em no ícone de busca.

4. Clique em Install.

   

   

5. Reinicie o IntelliJ IDEA. Após a reinicialização, o ícone do Alibaba Cloud Toolkit aparecerá na barra de ferramentas.

Se já tiver o plug-in instalado, atualize-o para a versão mais recente na mesma página de configurações de Plugins .

Etapa 2: Configurar sua conta Alibaba Cloud

Configure seu par de AccessKey para que o plug-in possa acessar o EDAS em seu nome.

1. No IntelliJ IDEA, selecione Tools > Alibaba Cloud > Preferences.

2. No painel de navegação à esquerda, selecione Alibaba Cloud Toolkit > Accounts.

3. Insira seu Access Key ID e Access Key Secret, e clique em OK.

   

Obter seu par de AccessKey:

• Se já possui uma conta Alibaba Cloud, clique em Get existing AK/SK na página Accounts. Faça login e recupere seu AccessKey ID e AccessKey secret na página de gerenciamento de AccessKey.

• Se não tiver uma conta, clique em Sign up para criar uma e obtenha seu par de AccessKey.

Se o serviço EDAS for executado no Apsara Stack Enterprise, configure um endpoint antes de prosseguir. Consulte Configurar um endpoint para o Apsara Stack Enterprise .

Etapa 3: Implantar seu aplicativo

1. No IntelliJ IDEA, selecione Tools > Alibaba Cloud > Deploy to EDAS > EDAS for Kubernetes Application. Como alternativa, selecione Run > Edit Configurations. Na caixa de diálogo Run/Debug configurations, selecione Templates > EDAS on Alibaba Cloud > EDAS for Kubernetes Application.

2. Na aba Settings da caixa de diálogo Deploy to EDAS, defina os seguintes parâmetros:

   Importante

   Se o aplicativo não aparecer na lista, consulte Autorizar um usuário RAM para o EDAS.

   Parâmetro	Descrição
   Region	Região onde o aplicativo será implantado.
   Namespace	Namespace de microsserviços destinado à implantação do aplicativo.
   Application	Nome do aplicativo.

   

3. Selecione um método de implantação:

   Método	Descrição
   Maven Build	Adiciona um job de build Maven para criar o pacote de implantação. Para projetos multimódulo, consulte Implantar um projeto multimódulo.
   Upload File	Faz upload de um pacote WAR ou JAR para implantação.
   Build Image	Cria uma imagem de contêiner a partir de um Dockerfile. Defina o Context Directory, o caminho do Dockerfile e a Version da imagem.
   Select Image	Implanta a partir de uma imagem de contêiner existente, selecionada na lista suspensa Select Image.

   

4. (Opcional) Clique em na aba Advanced para configurar parâmetros adicionais de implantação. Para obter detalhes completos sobre os parâmetros, consulte a referência da API DeployK8sApplication.

   • Application Environment: Define o ambiente de execução. Especifique uma nova PackageVersion sempre que implantar.

   • Startup Command: Especifica o comando e os argumentos executados na inicialização do contêiner.

   • Environments: Define variáveis de ambiente para o aplicativo.

   • Persistence: Configura volumes de armazenamento persistente.

   • Storage: Configura o armazenamento local.

   • Application Management: Define hooks de ciclo de vida e sondas de integridade:

     Configuração	Descrição
     Poststart	Um hook de ciclo de vida do contêiner acionado após a criação do contêiner. Se o handler falhar, o contêiner será interrompido e a política de reinicialização determinará se ele deve ser reiniciado.
     PreStop	Um hook de ciclo de vida do contêiner acionado antes da exclusão do contêiner. O handler é executado antes que a solicitação de exclusão chegue ao daemon do docker. O daemon envia um sinal SIGTERM independentemente do resultado do handler.
     Liveness	Uma sonda de integridade que verifica a integridade do aplicativo. Se não estiver íntegro, o Kubernetes exclui e recria o contêiner.
     Readiness	Uma sonda de integridade que verifica se o aplicativo foi iniciado e está funcionando conforme o esperado. Caso o aplicativo não consiga executar como esperado, o status do contêiner é atualizado.

   

5. Clique em Apply e, em seguida, clique em Run. Verifique o log de implantação na aba Console do IntelliJ IDEA para confirmar o resultado.

Implantar um projeto multimódulo

Para projetos Maven multimódulo, o último job Maven na seção Before launch deve compilar o submódulo que você deseja implantar.

Exemplo: O projeto CarShop tem a seguinte estrutura:

carshop
├── itemcenter-api
├── itemcenter
├── detail

Tanto itemcenter quanto detail dependem de itemcenter-api. Para implantar o submódulo itemcenter, adicione estes dois jobs Maven à seção Before launch:

1. Execute mvn clean install no projeto pai CarShop.

2. Execute mvn clean package no submódulo itemcenter.

Autorizar um usuário RAM para o EDAS

Se um usuário RAM não conseguir visualizar aplicativos na lista de implantação, ele não está sincronizado com o EDAS ou não tem as permissões necessárias. Escolha uma das abordagens abaixo para conceder acesso.

Configurar um endpoint para o Apsara Stack Enterprise

Se o serviço EDAS for executado no Apsara Stack Enterprise, configure um endpoint no Alibaba Cloud Toolkit antes de implantar. Entre em contato com o suporte técnico do EDAS para obter o valor do endpoint.

1. Na caixa de diálogo Preference (Filtered), selecione Appearance & Behavior > Endpoint.

2. Insira o valor do endpoint e clique em Apply and Close.