O Cloud Code instala e gerencia automaticamente o minikube. Se
você tiver desativado o gerenciamento de dependências, adicione o binário do minikube ao PATH.
Antes de começar
- Instale o Git para que o Cloud Code possa realizar operações do Git, como clonar uma amostra.
- Instale o plug-in do Cloud Code, caso ainda não tenha feito isso.
Criar um aplicativo usando um modelo
O Cloud Code vem com uma coleção de modelos de exemplo de código para você começar rapidamente. Para criar um aplicativo do Kubernetes usando uma amostra existente, siga estas etapas:
- Inicie a paleta de comandos (pressione
Ctrl/Cmd+Shift+Pou clique em View > Command Palette) e execute Cloud Code: New Application. - Selecione Aplicativo do Kubernetes como o tipo de amostra.
- Selecione um modelo baseado na linguagem que você quer usar dentre as opções disponíveis: Node.js, Go, Python e Java.
Escolha um local de aplicativo de sua preferência na máquina local e clique em Criar novo aplicativo para salvar.
O Cloud Code clona a amostra que você escolheu e abre seu novo projeto para uso.
Exemplo de estrutura de aplicativos
Os aplicativos criados a partir de modelos em todas as linguagens têm quase a mesma estrutura. Essa não é a única estrutura compatível, mas é a opção recomendada ao dar os primeiros passos.
Por exemplo, a estrutura do aplicativo Guestbook Node.js tem esta aparência:
.
|---- .vscode
| └---- launch.json
|---- kubernetes-manifests
| |---- guestbook-backend.deployment.yaml
| |---- guestbook-backend.service.yaml
| |---- guestbook-frontend.deployment.yaml
| |---- guestbook-frontend.service.yaml
| |---- mongo.deployment.yaml
| └---- mongo.service.yaml
|---- src
| |---- backend
| | |---- Dockerfile
| | |---- index.js
| | |---- app.js
| | └---- package.json
| |---- frontend
| |---- Dockerfile
| |---- index.js
| | |---- app.js
| └---- package.json
└---- skaffold.yaml
Para analisar mais detalhadamente este aplicativo de amostra de livro de visitas do Node.js para o Kubernetes, veja alguns arquivos importantes e seus respectivos usos:
- .vscode
extensions.json: solicitação de download de extensões relacionadas ao abrir este projetolaunch.json: iniciar configuração (do tipocloudcode.kubernetes) para executar ou depurar o aplicativo do Kubernetestasks.json: informações de configuração para tarefas do Visual Studio Code
- kubernetes-manifests
guestbook-backend.deployment.yaml: especificação do pod para os nós de back-endguestbook-frontend.deployment.yaml: especificação do pod para os nós de front-endmongo.deployment.yaml: especificação do pod para o banco de dados
- src
(backend|frontend)/app.js: código do Node.js com a lógica do servidor da Web(backend|frontend)/Dockerfile: usado para criar a imagem do contêiner do nosso programa
skaffold.yaml: arquivo de configuração do Skaffold, que o Cloud Code usa para criar, implantar e depurar aplicativos do Kubernetes
Usar seu próprio aplicativo
Para saber como usar um projeto atual, consulte Usar o Cloud Code com um aplicativo do Kubernetes.
Definir o contexto do Kubernetes
Antes de executar o aplicativo, verifique se você está configurado para implantar o aplicativo no contexto de sua preferência. É possível especificar isso na configuração.
Configuração
Ao usar a configuração de execução Cloud Code: Develop on Kubernetes, é possível personalizar a implantação definindo as configurações disponíveis.
Para adicionar ou editar configurações, acesse Run > Open Configurations e edite ou adicione configurações.Criar e implantar em um cluster do Minikube
Iniciar um cluster do Minikube
O Cloud Code instala e gerencia automaticamente o minikube. Se
você tiver desativado o gerenciamento de dependências, adicione o binário do minikube ao PATH.
- Inicie a paleta de comandos (pressione
Ctrl/Cmd+Shift+Pou clique em Visualizar > Paleta de comandos) e execute o comando Cloud Code: Control minikube. - Clique em minikube para Escolher um cluster do Minikube (perfil) para controlar e clique em Iniciar.
Executar no minikube
- Inicie a paleta de comandos e execute Cloud Code: Run on Kubernetes.
- Clique em Sim para Usar o contexto atual (minikube) para executar o app?
O Cloud Code executa seu app em um cluster do minikube. Se for necessário, autorize o Cloud Shell a usar suas credenciais para fazer uma chamada de APIGoogle Cloud .
Confira os detalhes da implantação na seção Sessões de desenvolvimento do Cloud Code.
Para conferir os URLs, clique em URLs do portfólio na seção Sessões de desenvolvimento e, em seguida, clique no link do URL para abrir o navegador com o aplicativo em execução.
Abrir um terminal interativo em um contêiner
- Clique em
Cloud Code e abra o explorador Sessões de desenvolvimento. - Expanda Recursos implantados e Pods.
- Clique com o botão direito do mouse em um contêiner e selecione Obter terminal.
Pausar ou interromper um cluster do minikube
- Inicie a paleta de comandos (pressione
Ctrl/Cmd+Shift+Pou clique em View > Command Palette) e execute o comando Cloud Code: Control minikube. - Depois que a opção Escolher um cluster do Minikube (perfil) para controlar for preenchida, clique em minikube e em Parar ou Pausar.
Criar e adicionar um cluster de outro provedor de nuvem
Se você estiver usando um cluster local ou de outro provedor, como o Azure ou a AWS, use as ferramentas do provedor para criar o cluster e adicioná-lo ao KubeConfig.
Trabalhar com outros clusters locais
Além do minikube, você também pode trabalhar com o Cloud Code se estiver usando o Docker Desktop (para Mac ou Windows).
Para que o Cloud Code funcione com um cluster local, verifique se a configuração padrão (por exemplo, ~/.kube/config) contém o cluster local. Esse cluster precisa ser definido como o contexto atual.
Por exemplo, se você estava usando um cluster local, docker-for-desktop, com o Docker Desktop, defina o cluster de sua preferência com o seguinte comando:
kubectl config use-context docker-for-desktop
A seguir
- Use a sincronização de arquivos e a recarga dinâmica para acelerar o desenvolvimento.
- Depurar seu aplicativo no Cloud Code