Premiers pas avec Cloud Code pour IntelliJ pour Kubernetes

Cloud Code vous permet de créer une application Kubernetes basée sur un exemple ou sur un projet existant.

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

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

1. Ouvrez File (Fichier) > New Project (Nouveau projet).
2. Sélectionnez Cloud Code : Kubernetes.
3. Sélectionnez un modèle dans la liste des applications de démarrage.

4. Indiquez un nom pour votre projet.

   Une fois que vous avez cliqué sur Finish (Terminer), Cloud Code clone le modèle choisi et ouvre le projet que vous venez de créer.

   Pour les modèles Java, vous êtes invité à importer des projets Maven pour synchroniser votre fichier pom.xml. Cliquez sur Add as Maven project (Ajouter en tant que projet Maven). Vous pouvez également importer les projets Maven nécessaires en cliquant sur Import Changes (Importer les modifications).

5. Les cibles d'exécution Kubernetes et IDE pour le déploiement de ce projet sont automatiquement créées et prêtes à être exécutées.

   Facultatif : vous pouvez également créer manuellement des cibles d'exécution :

   1. Sélectionnez la liste déroulante Exécuter la configuration, puis cliquez sur Modifier les configurations.
   2. Cliquez sur + Ajouter une configuration pour ajouter une nouvelle configuration d'exécution.
   3. Accédez à Cloud Code : Kubernetes.
   4. Saisissez un nom pour votre nouvelle configuration (par défaut, "Sans nom").
   5. Cliquez sur OK pour créer votre cible d'exécution.
   Remarque : Si vous êtes connecté à Google Cloud dans votre IDE et qu'un projet par défaut est défini, Cloud Code utilise votre dépôt d'images de conteneurs par défaut.. Pour spécifier une autre image de conteneur, consultez la page Configurer les paramètres d'images de conteneur.

Utiliser votre propre application

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

Remarque:Pour développer et tester une application, créez et l'application sur un cluster hors production.
Pour les modifications qui seront déployées en production, utilisez un workflow CI/CD automatisé.

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.

Si vous souhaitez changer de contexte, vous pouvez le faire à l'aide de l'explorateur Kubernetes, accessible depuis son panneau sur la droite, ou en utilisant Outils > Cloud Code > Kubernetes > Afficher l'explorateur de cluster.

Pour optimiser votre boucle de développement en récupérant rapidement les modifications d'un certain type sans avoir à recréer d'image, vous pouvez activer la synchronisation des fichiers et le rechargement à chaud.

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 à Exécuter > Modifier les configurations.

Options de stockage d'images de conteneurs

Si vous avez choisi un cluster distant comme contexte, choisissez un registre d'images vers lequel les images seront envoyées. Accédez à Run > Edit configurations (Exécuter > Modifier les configurations) pour définir le registre d'images dans vos Run/Debug Configurations (Configurations d'exécution/de débogage).

Consultez la sur le stockage de votre image de conteneur pour en savoir plus.

Paramètres de compilation

Cloud Code est compatible avec les types d'artefacts Docker, Jib et Buildpacks. Pour savoir comment définir le compilateur souhaité et les paramètres associés, consultez le guide Configurer les préférences de compilation d'images de conteneurs.

Personnaliser votre configuration de lancement

Pour configurer l'exécution de votre application, vous pouvez personnaliser votre skaffold.yaml.

Vous pouvez également configurer votre lancement dans vos configurations d'exécution/de débogage. Pour modifier vos configurations, accédez à Run > Modifiez les configurations.

Pour en savoir plus sur la personnalisation de votre configuration de lancement, consultez la section Kubernetes dans Cloud Code.

Remarque :Cloud Code est conçu pour fonctionner avec Cloud Build : Pour compiler une application existante à l'aide de l'infrastructure Google Cloud, consultez la documentation Skaffold pour Cloud Build.

Exécuter votre application

Une fois votre application configurée, vous pouvez l'exécuter sur un cluster Kubernetes et le voir en direct, en tirant parti skaffold dev Vous pouvez exécuter votre application sur un cluster local (par exemple, Minikube ou Docker Desktop), Google Kubernetes Engine ou tout autre fournisseur cloud.

Remarque :Si vous travaillez avec un cluster Autopilot privé, il se peut que vous rencontriez un problème Erreur lors de l'extraction d'une image en dehors du registre d'images pour votre projet, par exemple à l'aide de Docker Hub. Pour résoudre ce problème, vous pouvez soit héberger l'image sur Container Registry, soit fournir un accès Internet sortant à vos nœuds privés.

1. Cliquez sur l'icône Run (Exécuter) pour l'action d'exécution de votre choix. Vous pouvez ensuite afficher les journaux d'application entrants dans la fenêtre de sortie sous l'onglet Journaux.

   Une fois le déploiement démarré, la liste des ports transférés pour votre application déployée s'affiche.

2. Une fois le déploiement effectué, vous êtes informé que de nouvelles URL de service sont disponibles. Cliquez sur l'onglet URL de service pour afficher les URL, puis cliquez sur le bouton Lien URL permettant d'ouvrir votre navigateur avec votre application en cours d'exécution.

   Vous pouvez également ouvrir le journal des événements, puis cliquer sur le lien pour ouvrir votre navigateur avec l'application en cours d'exécution.

   Le volet Ressources déployées affiche ce que vous avez déployé pendant la session de développement.

Voir les journaux

En plus d'afficher les journaux des pods en cours d'exécution en tant que flux en direct dans la sortie du terminal à mesure que vous développez et exécutez votre application, vous pouvez consulter les journaux d'un pod spécifique en accédant à l'explorateur Kubernetes.

Pour afficher les journaux d'un pod spécifique, procédez comme suit :

1. Accédez à l'explorateur Kubernetes. Il peut s'agir accessible depuis le panneau latéral sur la droite ou à l'aide du menu Outils > Cloud Code > Kubernetes > Affichez l'explorateur de cluster.

2. Sélectionnez le pod pour lequel vous souhaitez consulter les journaux.

3. Effectuez un clic droit sur le pod, puis sélectionnez Stream Logs (Diffuser des journaux). Vous pouvez également diffuser les journaux de conteneurs individuels s'exécutant dans des pods.

   La console de l'explorateur Kubernetes affiche les journaux.

Apporter des modifications, recréer et nettoyer

Si le mode montre est défini sur À la demande dans votre configuration de lancement et que vous souhaitez d'apporter des modifications à l'application, puis recompilez et redéployez application:

1. Apportez les modifications souhaitées, puis enregistrez-les.

2. Cliquez sur l'icône Trigger Build and Deploy (Compiler et déployer) ou appuyez sur Option + Ctrl/Cmd + Comma pour recompiler et redéployer l'application.

3. Pour arrêter l'exécution de l'application, cliquez sur l'icône Arrêter ou appuyez sur Ctrl/Cmd + F2.

Une fois l'application arrêtée, toutes les ressources Kubernetes déployées sont supprimés du cluster. Vous pouvez modifier ce comportement à l'aide de l'option cleanUp dans votre configuration de lancement.

Stocker des secrets

Si votre code inclut des données potentiellement sensibles telles que des clés API, des mots de passe et des certificats, nous vous recommandons de les stocker en tant que secrets. Avec Cloud Code, vous pouvez stocker ces secrets en toute sécurité dans Secret Manager et les récupérer de manière automatisée lorsque vous en avez besoin.

Pour plus d'informations sur la création et la gestion des secrets avec Cloud Code, consultez le guide de Secret Manager.

Afficher les détails de la ressource

L'explorateur Kubernetes affiche les clusters, les espaces de noms, les nœuds, les charges de travail (déploiements, ensembles d'instances dupliquées, pods et conteneurs), les services et les entrées, les configurations (secrets, mappages de configuration, etc.) et le stockage (volumes, etc.). Avec l'explorateur Kubernetes, vous pouvez effectuer des actions uniques sur certaines de ces ressources.

Pour en savoir plus sur l'affichage des détails des ressources, consultez la présentation de Kubernetes.

Étape suivante

• Explorez vos options de compilation avec les buildpacks, Jib ou Docker.
• Utilisez la synchronisation des fichiers et le hot reload pour accélérer le développement.
• En savoir plus sur l'assistance pour l'édition YAML dans Cloud Code

Obtenir de l'aide

Pour envoyer des commentaires ou signaler un problème dans votre IDE IntelliJ, accédez à Outils > Cloud Code > Aide / À propos > Envoyer des commentaires ou signaler un problème pour signaler un problème sur GitHub, ou posez une question sur Stack Overflow.