Initiation à IBM Cloud Shell

Dans ce tutoriel de démarrage, vous utilisez IBM® Cloud Shell pour cloner un exemple d'application Node.js. IBM Cloud Shell est un espace de travail shell basé sur le cloud auquel vous pouvez accéder via votre navigateur. Cloud Shell est préconfiguré avec le IBM Cloud CLI complet et des tonnes de plug-ins et d'outils que vous pouvez utiliser pour gérer les applications, les ressources et l'infrastructure.

Vous utilisez Cloud Shell pour la première fois ? Regardez la vidéo de démonstration pour voir comment vous pouvez commencer à utiliser le service à partir de la console IBM Cloud.

Avant de commencer

Si vous n'avez pas encore de compte IBM Cloud, créez-en un et connectez-vous.
Notez les informations d'accès au compte suivantes qui peuvent affecter votre accès à Cloud Shell et à ses fonctions :
- Un administrateur de compte peut accorder à des utilisateurs spécifiques l'accès à Cloud Shell et à ses fonctions, même si les paramètres Cloud Shell sont désactivés au niveau du compte. Pour plus d'informations, voir Affectation de l'accès à Cloud Shell et à ses fonctions au niveau de l'utilisateur.
- Les propriétaires de compte ou les utilisateurs disposant d'un accès administrateur à Cloud Shell peuvent activer ou désactiver des fonctions Cloud Shell pour un compte. Les fonctions disponibles dans cette édition sont Envoi et téléchargement de fichiers et Aperçu Web. Les paramètres de fonction s'appliquent uniquement aux emplacements Cloud Shell activés. Pour plus d'informations, voir Activation ou désactivation de Cloud Shell pour un compte.
- Pour plus d'informations, voir Rôles et actions IAM.

Démarrage d'une session dans IBM Cloud Shell

Dans la console IBM Cloud, cliquez sur l'icône IBM Cloud Shell . Une session démarre et vous connecte automatiquement par l'intermédiaire de l'interface de ligne de commande IBM Cloud.

Clonage de l'exemple d'application Node.js

Votre session Cloud Shell démarre dans le répertoire de base temporaire /home/<user-name>. Clonez l'application d'exemple d' Node.js Express dans ce répertoire, puis accédez au répertoire de l'application d'exemple en exécutant les commandes suivantes.

git clone https://github.com/IBM/nodejs-express-app.git

cd nodejs-express-app

Dans le répertoire de votre application, exécutez la commande suivante pour afficher les nouveaux fichiers.

ls

Vous constatez que votre répertoire nodejs-express-app contient tous les fichiers et les dossiers de l'exemple d'application.

Dockerfile  Dockerfile-tools  LICENSE  README.md  package-lock.json
package.json  public  scripts  server  test

Prévisualisation de l'application en local

Vous pouvez le démarrer dans Cloud Shell et le prévisualiser localement.

Commencez par télécharger les dépendances du projet de l'exemple d'application Node.js.
```
npm install --only=prod
```
Démarrez l'application.
```
npm run start
```
Lorsqu'elle fonctionne, l'application indique l'emplacement auquel son interface utilisateur est disponible. Pour Cloud Shell, vous devez noter uniquement le port, qui dans ce cas est 3000.
```
> nodejsexpressapp@1.0.0 start /home/my-user-name/nodejs-express-app
> node server/server.js

App UI available http://localhost:3000
Swagger UI available http://localhost:3000/swagger/api-docs
```
Dans la barre de menus Cloud Shell, cliquez sur l'icône Aperçu Web et sélectionnez le port 3000.

L'aperçu de votre application s'ouvre dans une nouvelle fenêtre. Un message de félicitations signifie que votre application s'exécute en local dans Cloud Shell.
Appuyez sur Control+C pour arrêter l'application.

Etapes suivantes

Cloud Shell vous permet d'exécuter rapidement des commandes sur votre compte IBM Cloud. Exemple :

Outre l'interface de ligne de commande IBM Cloud, Cloud Shell est préconfiguré avec tous les plug-in d'interface de ligne de commande IBM Cloud et de nombreux outils et environnements d'exploitation qui facilitent le travail dans le cloud. Pour la liste complète, voir Plug-in et outils installés.