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 d'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. Attribuez un nom à 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 connaître la procédure à suivre pour utiliser un projet existant, consultez la page Utiliser Cloud Code avec une application Kubernetes existante.

Remarque:Pour développer et tester une application, créez et exécutez celle-ci 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: Develop on 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 transférer les images. Accédez à Run > Edit configurations (Exécuter > Modifier les configurations) pour définir le registre d'images dans vos Configurations d'exécution/de débogage.

Pour en savoir plus, consultez le guide sur le stockage de votre image de conteneur.

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 le fonctionnement de votre application, vous pouvez personnaliser votre fichier skaffold.yaml.

Vous pouvez également configurer votre lancement dans vos configurations d'exécution/de débogage. Pour modifier vos configurations, accédez à Run > Edit configurations (Exécuter > Modifier les configurations).

Pour en savoir plus sur la personnalisation de votre configuration de lancement, consultez la documentation sur 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 que vous avez configuré une application, vous pouvez l'exécuter sur un cluster Kubernetes et l'afficher en direct à l'aide de 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 utilisez un cluster Autopilot privé, vous pouvez rencontrer une erreur d'extraction d'image lorsque vous extrayez une image en dehors du registre d'images de votre projet, par exemple à l'aide de Docker Hub. Pour résoudre ce problème, vous pouvez héberger l'image sur Container Registry ou fournir un accès Internet sortant pour vos nœuds privés.

1. Cliquez sur l'icône Exécuter sur 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 du service pour afficher la ou les URL, puis cliquez sur le lien de l'URL pour 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 Deployed Resources (Ressources déployées) montre ce que vous avez déployé au cours de la session de développement.

Afficher 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. Vous pouvez y accéder depuis le panneau latéral de droite, ou via Tools > Cloud Code > Kubernetes > View Cluster Explorer (Outils > Cloud Code > Kubernetes > Afficher 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.

Modifier, recréer et nettoyer

Si le mode de visionnage est défini sur À la demande dans votre configuration de lancement et que vous souhaitez modifier votre application, puis la recompiler et la redéployer:

1. Apportez vos modifications et enregistrez-les.

2. Cliquez sur l'icône Trigger Build and Deploy (Déclencher la compilation et le déploiement) 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 Stop (Arrêter) ou appuyez sur Ctrl/Cmd + F2.

Une fois l'application arrêtée, toutes les ressources Kubernetes déployées sont supprimées du cluster. Vous pouvez modifier ce comportement à l'aide de l'indicateur 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 et mappages de configuration, par exemple) et le stockage (volumes). L'explorateur Kubernetes vous permet d'effectuer des actions uniques sur certaines de ces ressources.

Pour savoir comment afficher les détails des ressources, consultez la présentation de Kubernetes.

Étapes suivantes

• Explorez vos options de compilation avec les packs de création, Jib ou Docker.
• Utilisez la synchronisation des fichiers et le hot reload pour accélérer le développement.
• Obtenez plus d'informations sur l'aide à l'édition YAML de 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.