Utiliser minikube pour le développement local dans Cloud Code pour VS Code

Cloud Code installe et gère automatiquement minikube. Si vous avez désactivé la gestion des dépendances, ajoutez le binaire minikube à votre PATH.

Avant de commencer

  1. Installez Git pour que Cloud Code puisse effectuer des opérations Git, comme cloner un exemple.
  2. Installez le plug-in Cloud Code si ce n'est pas déjà fait.

Créer une application à partir d'un modèle

Cloud Code est fourni avec une collection de modèles d'exemples de code pour vous aider à démarrer rapidement. Pour créer une application Kubernetes à l'aide d'un exemple existant, procédez comme suit :

  1. Lancez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes), puis exécutez Cloud Code : Nouvelle application.
  2. Sélectionnez Kubernetes application (Application Kubernetes) comme type d'exemple.
  3. Sélectionnez un exemple en fonction du langage que vous souhaitez utiliser parmi les options disponibles : NodeJS, Go, Python, Java.

  4. Choisissez l'emplacement de votre choix pour l'application sur votre machine locale, puis cliquez sur Créer une application pour enregistrer.

    Cloud Code clone l'exemple que vous avez choisi et ouvre votre nouveau projet pour l'utiliser.

Exemple de structure d'application

Tous les exemples d'application ont une structure quasiment identique, quel que soit le langage. Cette structure n'est pas la seule possible, mais elle est recommandée lors du démarrage.

Par exemple, la structure de l'application Node.js Guestbook ressemble à ceci :

.
|---- .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

En observant de plus près cet exemple d'application de livre d'or Node.js Kubernetes, voici quelques fichiers clés et leurs utilisations :

  • .vscode
    • extensions.json : invitation à télécharger les extensions associées à l'ouverture du projet.
    • launch.json : configuration de lancement (de type cloudcode.kubernetes) pour exécuter ou déboguer l'application Kubernetes.
    • tasks.json : informations de configuration des tâches Visual Studio Code.
  • kubernetes-manifests
    • guestbook-backend.deployment.yaml : spécification de pod pour les nœuds de backend.
    • guestbook-frontend.deployment.yaml : spécification de pod pour les nœuds de frontend.
    • mongo.deployment.yaml : spécification de pod pour la base de données.
  • src
    • (backend|frontend)/app.js : code Node.js contenant la logique de serveur Web.
    • (backend|frontend)/Dockerfile : permet de compiler l'image de conteneur pour notre programme.
  • skaffold.yaml : un fichier de configuration que Cloud Code utilise pour compiler, déployer et déboguer les applications Kubernetes

Utiliser votre propre application

Pour savoir comment utiliser un projet existant, consultez Utiliser Cloud Code avec une application Kubernetes existante.

Définir votre contexte Kubernetes

Avant d'exécuter votre application, assurez-vous que vous êtes prêt à la déployer dans le contexte Kubernetes de votre choix. Vous pouvez le spécifier dans votre configuration.

Configuration

Lorsque vous utilisez la configuration d'exécution Cloud Code : Développer sur Kubernetes, vous pouvez personnaliser votre déploiement en configurant les paramètres disponibles.

Pour ajouter ou modifier des configurations, accédez à Run > Open Configurations (Exécuter > Ouvrir les configurations), puis modifiez ou ajoutez des configurations.

Créer et déployer sur un cluster minikube

Démarrer un cluster minikube

Cloud Code installe et gère automatiquement minikube. Si vous avez désactivé la gestion des dépendances, ajoutez le binaire minikube à votre PATH.

  1. Lancez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes), puis exécutez la commande Cloud Code : contrôler minikube.
  2. Cliquez sur minikube pour Choisir un cluster (profil) Minikube à contrôler, puis cliquez sur Démarrer.

Exécuter sur minikube

  1. Lancez la palette de commandes et exécutez Cloud Code : Exécuter sur Kubernetes.
  2. Cliquez sur Oui pour Utiliser le contexte actuel (minikube) pour exécuter l'application ?

  3. Cloud Code exécute votre application dans votre cluster Minikube. Si vous y êtes invité, autorisez Cloud Shell à utiliser vos identifiants pour effectuer un appel d'APIGoogle Cloud .

    Affichez les détails du déploiement dans la section Sessions de développement de Cloud Code.

  4. Pour afficher les URL, cliquez sur URL de redirection de port dans la section Sessions de développement, puis cliquez sur le lien de l'URL pour ouvrir votre navigateur avec votre application en cours d'exécution.

Ouvrir un terminal interactif vers un conteneur

  1. Cliquez sur Cloud Code, puis développez l'explorateur Sessions de développement.
  2. Développez Ressources déployées, puis Pods.
  3. Effectuez un clic droit sur un conteneur, puis cliquez sur Get Terminal (Obtenir un terminal).

Mettre en pause ou arrêter un cluster minikube

  1. Lancez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes), puis exécutez la commande Cloud Code : contrôler minikube.
  2. Une fois l'option Choisir un cluster (profil) Minikube à contrôler affichée, cliquez sur minikube, puis sur Arrêter ou Mettre en veille.

Créer et ajouter un cluster depuis un autre fournisseur de services cloud

Si vous utilisez un cluster sur site ou un cluster d'un autre fournisseur tel qu'Azure ou AWS, utilisez les outils du fournisseur pour créer le cluster et l'ajouter à votre KubeConfig.

Travailler avec d'autres clusters locaux

En plus de minikube, vous pouvez utiliser Cloud Code si vous utilisez Docker Desktop (pour Mac ou Windows).

Pour que Cloud Code fonctionne avec un cluster local, assurez-vous que votre configuration par défaut (par exemple, ~/.kube/config) contient bien votre cluster local. Ce cluster doit être défini comme contexte actuel.

Par exemple, si vous utilisez un cluster local, docker-for-desktop, avec Docker Desktop, définissez votre cluster préféré à l'aide de la commande suivante :

kubectl config use-context docker-for-desktop

Étapes suivantes

Obtenir de l'aide

Pour envoyer des commentaires, posez une question sur Stack Overflow. Si vous êtes un client Google Cloud, vous pouvez envoyer des demandes via les canaux d'assistance Google Cloud standards.