Esta página foi traduzida pela API Cloud Translation.
Switch to English

Como executar e desenvolver um aplicativo

Agora que está tudo pronto, escolha uma execução regular do aplicativo ou inicie um ciclo de iteração de desenvolvimento no ambiente de desenvolvimento integrado para propagar qualquer alteração feita na origem e nas dependências para o aplicativo ativo. Nesta página, usamos o app de amostra Guestbook para ilustrar a execução e o desenvolvimento na experiência do Kubernetes.

Como escolher uma ação de execução

Antes da execução

Antes de executar o aplicativo, verifique se você está pronto para implantar o aplicativo no contexto do Kubernetes de sua preferência. Isso pode ser especificado na configuração "Executar no Kubernetes", na guia "Executar" e na seção "Preferências de implantação".

Se você quiser alterar seu contexto atual, é possível fazer isso com o Kubernetes Explorer, acessível pelo painel da barra lateral à direita ou usando . Ferramentas > Cloud Code > Kubernetes > Ver Cluster Explorer.

Para otimizar o loop de desenvolvimento por meio da seleção rápida de alterações de arquivos de um determinado tipo sem precisar executar uma recriação de imagem, ative a sincronização de arquivos e a atualização a quente.

Executar no Kubernetes

Para uma execução regular do seu aplicativo, use o objeto de execução do Kubernetes, Executar no Kubernetes Ícone do botão de execução, para criar a imagem e implantar o projeto no cluster do Kubernetes. As origens e dependências do projeto não são monitoradas, e o processo do Skaffold termina quando a imagem e a implantação são concluídas.

Implantação comum usando a ação de execução

Para obter mais informações sobre como personalizar sua implantação, consulte as opções de configuração disponíveis.

Desenvolvimento contínuo no Kubernetes

Clique na ação de execução Desenvolver no Kubernetes Ícone do botão de execução para iniciar o ciclo de desenvolvimento no seu cluster do Kubernetes. Após o ciclo de desenvolvimento ser iniciado, o Cloud Code, que usa o Skaffold, cria uma imagem para o projeto e, em seguida, marca essa imagem, envia-a para o repositório configurado e usa o kubectl para implantar os manifestos do Kubernetes do projeto.

Como iniciar o ciclo de desenvolvimento do cluster do Kubernetes

Para obter mais informações sobre como personalizar sua implantação, consulte as opções de configuração disponíveis.

Como visualizar o aplicativo implantado

  1. Clique no botão "Executar" na ação de execução de sua preferência para visualizar os registros de aplicativo de entrada na janela de saída.

    Após o início da implantação, você verá a lista de portas encaminhadas do aplicativo implantado.

    Como visualizar registros de stream do aplicativo Kubernetes

  2. Quando a implantação for concluída, você verá uma notificação informando que o serviço agora pode ser acessado pelos URLs locais. Clique em "Visualizar" para abrir o log de eventos.

    Notificação informando que o URL para acessar o aplicativo ativo agora está disponível no Log de eventos

    Em Log de eventos, encontre a porta em que o aplicativo está sendo exibido. Clique no link para abrir o navegador com o aplicativo em execução.

  3. Veja seu aplicativo recém-implantado.

    Como executar o aplicativo Guestbook no localhost:8080

Ver registros

Embora seja possível ver uma transmissão ao vivo dos registros de pods dentro da saída do terminal enquanto você está desenvolvendo e executando o aplicativo, também é possível ver os registros de um pod específico navegando até o Kubernetes Explorer.

Para ver os registros de um pod específico, siga estas etapas:

  1. Navegue até o Kubernetes Explorer. Ele pode ser acessado no painel lateral à direita ou usando Ferramentas > Cloud Code > Kubernetes > Visualizar o Cluster Explorer.

    Painel do Kubernetes Explorer aberto usando a guia na barra de tarefas do lado direito

  2. Selecione o pod do qual você quer ver os registros.

  3. Clique com o botão direito do mouse no pod e selecione Registros de stream. Como alternativa, é possível transmitir registros de contêineres individuais em execução em pods.

    Isso gerará registros para o Console do Kubernetes Explorer.

    Streaming de registros de um pod usando o menu do botão direito do mouse para gerar registros no Console do Kubernetes Explorer

Como adicionar novos recursos no desenvolvimento do Kubernetes

Se você tiver iniciado um ciclo de iteração de desenvolvimento com "Desenvolver no Kubernetes" e tiver adicionado mais recursos ao seu projeto, você verá como essas alterações são implantadas no seu cluster do Kubernetes sem interromper e remover a implantação, sem criar e marcar manualmente a imagem ou atualizar o cluster.

Se você estiver acompanhando o app Guestbook:

  1. Abra o arquivo "FrontendController.java" em src/main/java/cloudcode/guestbook/frontend e adicione esse novo endpoint à classe FrontendController:

     @RequestMapping("/greeting")
     @ResponseBody
     public String greeting(@RequestParam(value="name", defaultValue="World") String name) {
        return String.format("Hello from Kubernetes with IntelliJ, %s!", name);
     }
     ```
    
  2. Adicione as importações necessárias para as novas anotações, RequestMapping e ResponseBody.

  3. Salve as alterações (Ctrl/Cmd-S) ou crie o projeto (use o menu Criar > Criar projeto).

    É possível visualizar os registros de progresso e implantação na janela do console. Depois que as alterações forem propagadas, confirme as atualizações visitando o novo URL do endpoint: localhost:8080/greeting.

    Como visualizar o endpoint recém-criado em um navegador

  4. Quando terminar, clique no botão "Parar" para encerrar a sessão de desenvolvimento contínuo. Essa ação faz com que o plug-in exclua todos os recursos do Kubernetes usados para a sessão de desenvolvimento.

Como armazenar chaves secretas

Se o código inclui dados possivelmente confidenciais, como chaves de API, senhas e certificados, é recomendável armazená-los como secrets. O Cloud Code permite armazenar esses secrets com segurança no Gerenciador de secrets e buscá-los de maneira programática quando precisar deles. Para uma visão detalhada de como criar e gerenciar secrets com o Cloud Code, consulte o guia do Gerenciador de secrets.

Como visualizar detalhes do recurso

Para acompanhar o status dos recursos do Kubernetes, use o Kubernetes Explorer, acessível pelo painel lateral à direita. Também é possível acessá-lo usando Ferramentas > Cloud Code > Kubernetes > Visualizar Cluster Explorer.

Painel do Kubernetes Explorer aberto usando a guia na barra de tarefas do lado direito

Use o Kubernetes Explorer para acessar informações sobre clusters, nós, cargas de trabalho e muito mais. Também é possível definir um contexto ativo, fazer streaming e visualizar registros e procurar descrições de recursos.

É possível executar um kubectl describe nos recursos implantados para exibir os detalhes dele clicando com o botão direito do mouse no rótulo do Kubernetes Explorer e selecionando Descrever.

Opção Descrever disponível ao clicar com o botão direito do mouse em um recurso apropriado no painel do Kubernetes Explorer e selecionar Descrever

Configuração

Ao usar as configurações de execução Executar no Kubernetes e Desenvolver no Kubernetes, personalize a implantação definindo as configurações disponíveis. Acesse as opções de configuração selecionando "Run Configuration" no menu suspenso e selecionando Edit Configurations.

Opções do Skaffold

  • Skaffold configuration: seleciona um arquivo de configuração skaffold.yaml. Será detectado automaticamente se você tiver um skaffold.yaml no seu projeto.
  • Perfil de implantação: seleciona um perfil das opções disponíveis configuradas no arquivo skaffold.yaml.
  • Variáveis de ambiente: permite configurar variáveis de ambiente extras para serem transmitidas ao processo de implantação do Skaffold. As sinalizações do Skaffold também podem ser configuradas como variáveis de ambiente a serem usadas nesse campo. Consulte a documentação de referência da CLI do Skaffold para uma lista abrangente de variáveis de ambiente disponíveis do Skaffold.
  • Nível de detalhes: permite definir o nível de detalhamento da saída como trace, debug, info, warn, error ou fatal. O nível de detalhes padrão é warn.

Opções do Kubernetes

  • Contexto de implantação: representa o contexto do Kubernetes no qual o aplicativo é implantado. O comportamento padrão, se um contexto de implantação não for especificado, será implantado no contexto do sistema atual, se houver.

    Se preferir não implantar no contexto atual, na seção Implantação de configurações de execução/depuração, escolha uma das seguintes opções:

    • Implantar localmente em um cluster do minikube: inicia um cluster minikube gerenciado pelo Cloud Code para executar o app e interrompe o cluster após a implantação ser interrompida. Se um cluster minikube já estiver em execução, o Cloud Code usará o cluster atual do Minikube para implantação.
    • Switch context and deploy to: altera o contexto atual no sistema para o contexto especificado na implantação.

      Como selecionar o contexto de implantação do Kubernetes em uma configuração do Cloud Code Kubernetes

  • Delete deployments when finished: exclui as implantações do Kubernetes quando o processo é finalizado. Esse é o comportamento padrão. Também é possível alternar essa configuração para impedir que as implantações sejam excluídas.

Opções de armazenamento de imagens de contêiner

Consulte o guia sobre como armazenar sua imagem de contêiner para detalhes.

Configurações da versão

O Cloud Code é compatível com tipos de artefato do Docker, Jib e Buildpacks. Consulte Como configurar o guia de preferências de criação de imagens de contêiner para saber como definir o builder preferencial e as configurações relevantes.

Como receber suporte

Para enviar feedback, relate um problema no GitHub ou faça uma pergunta no Stack Overflow.