Mise en route avec les tutoriels de solution

Les tutoriels de solution fournissent des instructions pas à pas sur la manière d'utiliser IBM Cloud pour implémenter des modèles courants basés sur les bonnes pratiques et des technologies éprouvées.

Avant d'accéder à la collection de tutoriels, ce guide vous aide à configurer votre environnement de développement afin de pouvoir suivre les instructions des guides de cette collection.

Objectifs

Installez les outils indispensables à une utilisation optimale d'IBM Cloud :

  • Interface de ligne de commande IBM Cloud - Interface de ligne de commande permettant d'interagir avec l'API IBM Cloud.
  • Docker - Permet de distribuer et d'exécuter des logiciels dans des packages appelés conteneurs.
  • kubectl - Interface de ligne de commande permettant d'exécuter des commandes pour les clusters Kubernetes.
  • oc - Gère les applications OpenShift et fournit des outils permettant d'interagir avec chaque composant de votre système.
  • Helm 3 - Permet de gérer les applications Kubernetes. Les graphiques Helm vous permettent de définir, d'installer et de mettre à niveau même l'application Kubernetes la plus complexe.
  • Terraform - Automatise la mise à disposition de vos ressources.
  • jq - Processeur JSON de ligne de commande simple et flexible.
  • Git - Système de contrôle de version gratuit et distribué à source ouverte.

Pour éviter l'installation de ces outils, vous pouvez utiliser Cloud Shell à partir de la console IBM Cloud.

Microsoft Windows

Pour les sections suivantes, il est supposé que vous exécutez Microsoft Windows 10 64 bits en tant qu'utilisateur disposant de droits de type Administrateur. Une fois que vous avez parcouru les sections spécifiques, effectuez la configuration commune à tous les systèmes d'exploitation.

CLI IBM Cloud

  1. Téléchargez et installez l'interface de ligne de commande IBM Cloud à partir de https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.

  2. Vérifiez l'installation en entrant :

    ibmcloud version

    Il peut être nécessaire de redémarrer votre machine après l'installation.

Docker

  1. Docker Desktop sous Windows est une option permettant d'exécuter des images de conteneur sous Windows. Vérifiez les termes du contrat de licence avant de poursuivre l'installation.

  2. Inscrivez-vous sur https://hub.docker.com/signup pour bénéficier d'un compte gratuit si vous n'en avez pas encore.

  3. Téléchargez et installez Docker Desktop sous Windows à partir de https://docs.docker.com/docker-for-windows/install/.

  4. Vérifiez l'installation en entrant :

    docker --version
docker run hello-world

    Il peut être nécessaire de vous déconnecter et d'attendre le démarrage du démon Docker.

kubectl

  1. Téléchargez kubectl à partir de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows.
  2. Déplacez le fichier binaire kubectl.exe dans votre variable PATH.
  3. Vérifiez l'installation en entrant :
    kubectl version --client=true

oc

  1. Téléchargez la version 4.x de l'interface de ligne de commande OpenShift (oc) la plus récente depuis https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Déplacez le fichier binaire oc.exe dans votre variable PATH.
  3. Vérifiez l'installation en entrant :
    oc version

Helm 3

  1. Téléchargez helm depuis https://github.com/helm/helm/releases/latest.
  2. Décompressez l'archive téléchargée.
  3. Déplacez le fichier binaire helm.exe dans votre variable PATH.
  4. Vérifiez l'installation en entrant :
    helm version

Terraform

  1. Téléchargez terraform à partir de https://developer.hashicorp.com/terraform/downloads.
  2. Décompressez l'archive téléchargée.
  3. Déplacez le fichier binaire terraform.exe dans votre variable PATH.
  4. Vérifiez l'installation en entrant :
    terraform version

Pour gérer les ressources IBM Cloud avec Terraform, vous devez également installer IBM Cloud Provider. A compter de Terraform 0.13, le fournisseur peut être téléchargé automatiquement depuis le registre de plug-in Terraform. Suivez les instructions de la documentation du fournisseur pour configurer la propriété required_providers dans vos modèles Terraform.

jq

  1. Téléchargez jq depuis https://jqlang.github.io/jq/.
  2. Renommez jq-win64.exe en jq.exe.
  3. Déplacez le fichier binaire jq.exe dans votre variable PATH.
  4. Vérifiez l'installation en entrant :
    jq --version

Git

  1. Téléchargez et installez git à partir de https://github.com/git-for-windows/git/releases/latest.
  2. Vérifiez l'installation en entrant :
    git --version

Effectuez la configuration commune à tous les systèmes d'exploitation.

Apple macOS

Pour les sections suivantes, il est supposé que vous exécutez macOS High Sierra ou version ultérieure en tant qu'utilisateur disposant de droits de type Administrateur. Une fois que vous avez parcouru les sections spécifiques, effectuez la configuration commune à tous les systèmes d'exploitation.

CLI IBM Cloud

  1. Téléchargez et installez l'interface de ligne de commande IBM Cloud à partir de https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Vérifiez l'installation en entrant :
    ibmcloud version

Docker

  1. Docker Desktop sur Mac est une option pour exécuter des images de conteneur sur macOS. Vérifiez les termes du contrat de licence avant de poursuivre l'installation. Les autres options incluent Podman.
  2. Inscrivez-vous sur https://hub.docker.com/signup pour bénéficier d'un compte gratuit si vous n'en avez pas encore.
  3. Téléchargez et installez Docker Desktop on Mac à partir de https://docs.docker.com/docker-for-mac/install/.
  4. Vérifiez l'installation en entrant :
    docker --version
docker run hello-world

kubectl

  1. Téléchargez kubectl depuis https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos.
  2. Rendez le fichier binaire kubectl exécutable.
    chmod +x ./kubectl
  3. Déplacez le fichier binaire dans votre variable PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Vérifiez l'installation en entrant :
    kubectl version --client=true

oc

  1. Téléchargez la version 4.x de l'interface de ligne de commande OpenShift (oc) la plus récente depuis https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Extrayez openshift-client-mac.tar.gz (Intel) ou openshift-install-mac-arm64.tar.gz (Apple Silicon):
    tar zxvf openshift-client-mac*.tar.gz oc
  3. Déplacez le fichier binaire oc dans votre variable PATH.
    sudo mv ./oc /usr/local/bin/oc
  4. Vérifiez l'installation en entrant :
    oc version
    macOS Catalina et les versions ultérieures peuvent vous demander un message indiquant que le développeur ne peut pas être vérifié. Pour que oc soit exécuté malgré tout, exécutez sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc.

Helm 3

  1. Téléchargez helm depuis https://github.com/helm/helm/releases/latest.
  2. Décompressez l'archive téléchargée.
  3. Déplacez le fichier binaire helm dans votre variable PATH.
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. Vérifiez l'installation en entrant :
    helm version
    macOS Catalina et les versions ultérieures peuvent vous demander un message indiquant que le développeur ne peut pas être vérifié. Pour que helm soit exécuté malgré tout, exécutez sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm.

Terraform

  1. Téléchargez terraform à partir de https://developer.hashicorp.com/terraform/downloads.
  2. Décompressez l'archive téléchargée.
  3. Déplacez le fichier binaire terraform dans votre variable PATH.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Vérifiez l'installation en entrant :
    terraform version

Pour gérer les ressources IBM Cloud avec Terraform, vous devez également installer IBM Cloud Provider. A compter de Terraform 0.13, le fournisseur peut être téléchargé automatiquement depuis le registre de plug-in Terraform. Suivez les instructions de la documentation du fournisseur pour configurer la propriété required_providers dans vos modèles Terraform.

jq

  1. Téléchargez jq à partir de https://jqlang.github.io/jq/.
  2. Renommez le fichier téléchargé en jq.
  3. Rendez le fichier binaire jq exécutable.
    chmod +x ./jq
  4. Déplacez le fichier binaire jq dans votre variable PATH.
    sudo mv ./jq /usr/local/bin/jq
  5. Vérifiez l'installation en entrant :
    jq --version
    macOS Catalina et les versions ultérieures peuvent vous demander un message indiquant que le développeur ne peut pas être vérifié. Pour que jq soit exécuté malgré tout, exécutez sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq.

Git

  1. Vérifiez que git est installé :
    git --version
    macOS peut vous inviter à installer les outils de développement. Ces outils incluent la ligne de commande git.

Effectuez la configuration commune à tous les systèmes d'exploitation.

Ubuntu Linux

Pour les sections suivantes, il est supposé que vous exécutez Ubuntu Linux en tant qu'utilisateur non root disposant d'un accès à des privilèges root. Une fois que vous avez parcouru les sections spécifiques, effectuez la configuration commune à tous les systèmes d'exploitation. Si vous utilisez le shell Cloud basé sur Linux, passez à la section sur le shell Cloud.

CLI IBM Cloud

  1. Téléchargez et installez l'interface de ligne de commande IBM Cloud à partir de https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Vérifiez l'installation en entrant :
    ibmcloud version

Docker

  1. Inscrivez-vous sur https://hub.docker.com/signup pour bénéficier d'un compte gratuit si vous n'en avez pas encore.
  2. Installez Docker Engine sur Ubuntu en suivant les instructions de la rubrique https://docs.docker.com/engine/install/ubuntu/.
  3. Vérifiez l'installation en entrant :
    docker --version
sudo docker run hello-world
    Pour exécuter Docker sous votre propre nom d'utilisateur au lieu de l'utilisateur root, suivez les étapes de post-installation.

kubectl

  1. Téléchargez kubectl à partir de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux.
  2. Rendez le fichier binaire kubectl exécutable.
    chmod +x ./kubectl
  3. Déplacez le fichier binaire dans votre variable PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Vérifiez l'installation en entrant :
    kubectl version --client=true

oc

  1. Téléchargez la version 4.x de l'interface de ligne de commande OpenShift (oc) la plus récente depuis https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Extrayez openshift-client-linux.tar.gz :
    tar zxvf openshift-client-linux.tar.gz oc
  3. Déplacez le fichier binaire oc dans votre variable PATH.
    sudo mv ./oc /usr/local/bin/oc
  4. Vérifiez l'installation en entrant :
    oc version

Helm 3

  1. Téléchargez helm depuis https://github.com/helm/helm/releases/latest.
  2. Décompressez l'archive téléchargée.
  3. Déplacez le fichier binaire helm dans votre variable PATH.
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. Vérifiez l'installation en entrant :
    helm version

Terraform

  1. Téléchargez terraform à partir de https://developer.hashicorp.com/terraform/downloads.
  2. Décompressez l'archive téléchargée.
  3. Déplacez le fichier binaire terraform dans votre variable PATH.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Vérifiez l'installation en entrant :
    terraform version

Pour gérer les ressources IBM Cloud avec Terraform, vous devez également installer IBM Cloud Provider. A compter de Terraform 0.13, le fournisseur peut être téléchargé automatiquement depuis le registre de plug-in Terraform. Suivez les instructions de la documentation du fournisseur pour configurer la propriété required_providers dans vos modèles Terraform.

jq

  1. Installez jq en utilisant la commande suivante :
    sudo apt install jq
  2. Vérifiez l'installation en entrant :
    jq --version

Git

  1. Installez git en utilisant la commande suivante :
    sudo apt install git
  2. Vérifiez l'installation en entrant :
    git --version

Effectuez la configuration commune à tous les systèmes d'exploitation.

Procédures communes à tous les systèmes d'exploitation

Les sections suivantes sont communes à tous les systèmes d'exploitation.

Plug-in de l'interface de ligne de commande IBM Cloud

Les plug-in étendent les fonctionnalités de l'interface de ligne de commande IBM Cloud en ajoutant des commandes spécifiques à un service.

  1. Installez les plug-in suivants :
    ibmcloud plugin install container-registry
ibmcloud plugin install cloud-object-storage
ibmcloud plugin install kubernetes-service
ibmcloud plugin install vpc-infrastructure
ibmcloud plugin install code-engine
    Pour afficher tous les plug-in disponibles, exécutez ibmcloud plugin repo-plugins et installez un plug-in ibmcloud plugin install <PLUGIN_NAME>

Compte GitHub

  1. Inscrivez-vous afin d'obtenir un compte gratuit sur https://github.com/.
  2. Créez un référentiel public sur https://github.com/new pour vous familiariser avec GitHub.

IBM Cloud GitLab

IBM Cloud met à votre disposition des référentiels Git hébergés créés à partir de GitLab Community Edition et accessibles avec les mêmes données d'identification que celles utilisées pour la connexion à IBM Cloud. Il est recommandé de configurer votre clé publique SSH pour simplifier les interactions de la ligne de commande avec les référentiels Git.

  1. Utilisez ces instructions pour générer une nouvelle paire de clés SSH si vous n'en avez pas.
  2. Ajoutez votre clé publique SSH à vos paramètres Git dans la région où vous prévoyez d'héberger vos référentiels Git, tels que Dallas(us-south.git.cloud.ibm.com), Londres(eu-gb.git.cloud.ibm.com) ou Francfort(eu-de.git.cloud.ibm.com).

Pour vérifiez la configuration, procédez comme suit :

  1. Créez un nouveau projet privé dans GitLab, sélectionnez l'option pour initialiser le référentiel avec un fichier README.
  2. Réservez le projet à partir de la ligne de commande en clonant avec le lien SSH.
  3. Mettez à jour le fichier README.
  4. Validez et envoyez les modifications.

Cloud Shell

oc

Suivez cette procédure si vous devez utiliser une autre version de l'interface de ligne de commande OpenShift que celle préinstallée :

  1. Téléchargez la dernière version stable de l'interface de ligne de commande 4.x OpenShift (oc)
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. Extrayez oc.tar.gz :
    tar zxvf oc.tar.gz oc
  3. Ajoutez votre répertoire de travail à PATH :
    export PATH=$PWD:$PATH
  4. Vérifiez l'installation en entrant :
    oc version