À propos de cet atelier de programmation
1. Avant de commencer
Cloud Shell est un outil de ligne de commande basé sur un navigateur qui vous permet d'accéder aux ressources Google Cloud. Cloud Shell vous permet de gérer facilement vos projets et vos ressources Cloud Console sans avoir à installer le SDK Cloud ni aucun autre outil sur votre système.
Vous utiliserez Cloud Shell pour créer et lancer une application Spring Boot sans quitter votre navigateur. Pour ce faire, vous allez utiliser l'exemple de code de la section Créer une application avec Spring Boot.
Conditions préalables
- Bonne connaissance des outils et du langage de programmation Java
- Une bonne connaissance des éditeurs de texte Linux standards tels que Vim, Emacs et nano
Objectifs de l'atelier
- Utilisez Cloud Shell.
- Créez une application Spring Boot simple dans Cloud Shell.
- Modifiez l'application à l'aide de l'éditeur de code de Cloud Shell.
- Lancez l'application à partir de Cloud Shell.
Prérequis
- Un projet Google Cloud
- Un navigateur tel que Google Chrome
2. Prérequis
Configuration de l'environnement au rythme de chacun
- Si vous n'avez pas encore de compte Google, vous devez en créer un. Connectez-vous à Cloud Console et créez un projet.
Notez l'ID du projet, un nom unique pour tous les projets Google Cloud (le nom figurant dans l'image est déjà pris et ne fonctionnera pas pour vous, malheureusement !). Elle sera désignée plus tard par PROJECT_ID dans cet atelier de programmation.
- Vous devez ensuite activer la facturation dans Cloud Console pour utiliser les ressources Google Cloud. Le coût de l'atelier de programmation ne devrait pas vous coûter plus que quelques dollars, mais il pourrait être plus élevé si vous décidez d'utiliser davantage de ressources ou de les laisser s'exécuter.
Les nouveaux utilisateurs de Google Cloud peuvent bénéficier d'un essai offert de 300 $.
Cloud Shell
Cette machine virtuelle basée sur Debian contient tous les outils de développement dont vous aurez besoin. Elle intègre un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud, ce qui améliore nettement les performances du réseau et l'authentification. Cela signifie que tout ce dont vous avez besoin pour cet atelier de programmation est un navigateur (oui, tout fonctionne sur un Chromebook).
- Pour activer Cloud Shell à partir de Cloud Console, il vous suffit de cliquer sur Activer Cloud Shell
(la configuration ne prend que quelques instants).
Une fois connecté à Cloud Shell, vous êtes normalement déjà authentifié et le projet PROJECT_ID est sélectionné :
gcloud auth list
Résultat de la commande
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
Résultat de la commande
[core] project = <PROJECT_ID>
Par défaut, Cloud Shell définit certaines variables d'environnement qui pourront s'avérer utiles pour exécuter certaines commandes dans le futur.
echo $GOOGLE_CLOUD_PROJECT
Résultat de la commande
<PROJECT_ID>
Si, pour une raison quelconque, le projet n'est pas défini, exécutez simplement la commande suivante :
gcloud config set project <PROJECT_ID>
Vous recherchez votre PROJECT_ID ? Vérifiez l'ID utilisé pour la configuration ou recherchez-le dans le tableau de bord Cloud Console.
- Pour finir, définissez la configuration du projet et de la zone par défaut :
gcloud config set compute/zone us-central1-f
Vous pouvez choisir parmi différentes zones. Pour en savoir plus, consultez la section Régions et zones.
3. Initialiser une nouvelle application Spring Boot
Une fois l'outil de ligne de commande Spring Boot installé, vous pouvez initialiser et démarrer une nouvelle application Web &Hello;World.
$ curl https://start.spring.io/starter.tgz \ -d dependencies=web -d baseDir=helloworld | tar -xzvf -
Cette opération crée un répertoire avec un nouveau projet Maven, avec pom.xml, un wrapper Maven et un point d'entrée d'application.
4. Créer un service RESTful à l'aide de l'éditeur de code
- Ouvrez l'éditeur de code en cliquant sur Launch editor (Lancer l'éditeur)
dans le menu Cloud Shell. - Une fois l'éditeur ouvert, recherchez le fichier
helloworld/src/main/java/com/example/demo/DemoApplication.java.
- Une fois le code ouvert, créez un contrôleur RESTful pour répondre à
Hello. Dans le fichierDemoApplication.java, ajoutez une nouvelle définition de classeHelloworlden plus de la définition actuelle.
src/main/java/com/example/demo/DemoApplication.java
package com.example;
...
// Add the import
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class DemoApplication {
...
}
// Add the controller
@RestController
class Helloworld {
@GetMapping("/")
public String greet() {
return "Hello!";
}
}- Enregistrez le fichier.
5. Exécuter l'application en local
- Vous pouvez démarrer l'application Spring Boot normalement avec le plug-in Spring Boot.
$ cd $HOME/helloworld $ ./mvnw -DskipTests spring-boot:run
- Une fois l'application démarrée, cliquez sur Aperçu sur le Web
dans la barre d'outils Cloud Shell, puis sur Prévisualiser sur le port 8080.
Un onglet s'ouvre dans votre navigateur et se connecte au serveur que vous avez démarré.
6. Félicitations
Vous avez appris à créer et à lancer une nouvelle application Web Spring Boot en Java directement depuis Cloud Shell.