O Cloud Code instala e gerencia o minikube automaticamente. Se você desativou o gerenciamento de dependências, adicione o binário do minikube ao seu 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 Cloud Code se ainda não tiver feito isso.
Criar um aplicativo com base em um modelo
O Cloud Code vem com uma coleção de modelos de exemplos de código para você começar rapidamente. Para criar um aplicativo do Kubernetes usando uma amostra, siga estas etapas:
- Abra a paleta de comandos (pressione
Ctrl/Cmd+Shift+Pou clique em Visualizar > Paleta de comandos) e execute Cloud Code: novo aplicativo. - Selecione Aplicativo do Kubernetes para o tipo de amostra.
- Selecione uma amostra com base na linguagem que você quer usar entre as opções disponíveis: NodeJS, Go, Python e Java.
Escolha um local preferido para o aplicativo na sua 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: um arquivo de configuração 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 Kubernetes atual.
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. Você pode especificar isso na sua configuração.
Configuração
Ao usar a configuração de execução Cloud Code: Develop on Kubernetes, é possível personalizar a implantação configurando as opções disponíveis.
Para adicionar ou editar configurações, acesse Executar > Abrir configurações 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 o minikube automaticamente. Se você desativou o gerenciamento de dependências, adicione o binário do minikube ao seu PATH.
- Abra a paleta de comandos (pressione
Ctrl/Cmd+Shift+Pou clique em Visualizar > Paleta de comandos) e execute o comando Cloud Code: controlar o minikube. - Clique em minikube em Escolher um cluster (perfil) do Minikube para controlar e clique em Iniciar.
Executar no minikube
- Abra a paleta de comandos e execute Cloud Code: Executar no 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 preciso, 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 ver os URLs, clique em URLs de encaminhamento de porta na seção Sessões de desenvolvimento e clique no link do URL para abrir o navegador com o aplicativo em execução.
Abrir um terminal interativo para um contêiner
- Clique em
Cloud Code e expanda o explorador Sessões de desenvolvimento. - Expanda Recursos implantados e depois Pods.
- Clique com o botão direito do mouse em um contêiner e selecione Obter terminal.
Pausar ou parar um cluster do minikube
- Abra a paleta de comandos (pressione
Ctrl/Cmd+Shift+Pou clique em Visualizar > Paleta de comandos) e execute o comando Cloud Code: controlar o minikube. - Depois que a opção Escolher um cluster (perfil) do Minikube 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 Azure ou AWS, use as ferramentas do provedor para criar e adicionar o cluster ao seu KubeConfig.
Trabalhar com outros clusters locais
Além do minikube, você 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 automática para acelerar o desenvolvimento.
- Depurar seu aplicativo no Cloud Code