O Cloud Code instala e gerencia automaticamente o minikube. Se
você desativou o gerenciamento de dependências, adicione o binário minikube ao PATH.
Antes de começar
- Instale o Git para que o Cloud Code pode executar operações 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 exemplo de código modelos 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 para o tipo de amostra.
- Selecione uma amostra com base no idioma que você quer usar opções: NodeJS, Go, Python, Java.
Escolha o local preferido para o aplicativo na sua máquina local e clique em Crie um 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 acessar as etapas para usar um projeto existente, 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 Visualizar > Command Palette) e Depois, execute o comando Cloud Code: controlar minikube. - Clique em minikube em 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 Yes em Use current context (minikube) to run the app?
O Cloud Code executa o app em um cluster do minikube. Se solicitado, autorize o Cloud Shell a usar suas credenciais para fazer chamada de API do Google 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. - Abra 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. - Após a opção Choose a Minikube cluster (profile) to control, for preenchida, clique em minikube e em Stop ou Pause.
Criar e adicionar um cluster de outro provedor de nuvem
Se você estiver usando um cluster no local ou de outro provedor, como Azure ou AWS, use as ferramentas do provedor para criar o cluster e adicioná-lo ao seu KubeConfig.
Trabalhar com outros clusters locais
Além de minikube, você pode trabalhar com o Cloud Code, se você 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
- Usar sincronização de arquivos e recarga automática para acelerar o desenvolvimento.
- Depurar seu aplicativo no Cloud Code