Prérequis pour la configuration du kit d'outils de développement conteneurisé dans un environnement Windows

Avant de configurer le kit d'outils de développement conteneurisé dans un environnement Windows, vous devez effectuer les étapes suivantes.

Avant de commencer

Windows Subsystem for Linux® version 2 (WSL 2) et Ubuntu sont largement utilisés pour configurer le kit d'outils de développement dans un environnement Windows. Par conséquent, il est nécessaire que vous ayez une connaissance adéquate de l'utilisation des systèmes WSL 2 et Ubuntu .

Procédure

  1. Installez Windows Subsystem for Linux version 2 (WSL 2) sur votre système Windows 10, s'il n'est pas déjà installé. Pour plus d'informations sur l'installation de Windows Subsystem for Linux version 2 (WSL 2), voir Windows Subsystem for Linux -Guide d'installation pour Windows 10.
  2. Téléchargez et installez Ubuntu 20.04 dans le cadre de WSL 2.
  3. Connectez-vous à votre terminal WSL 2 Ubuntu .
  4. Téléchargez et installez Docker. Pour plus d'informations, voir Installation de Docker Engine sur Ubuntu.
    Important: Vous devez configurer l'environnement du kit d'outils de développement en tant qu'utilisateur non superutilisateur. Vous devez également ajouter l'utilisateur au groupe docker . Pour plus d'informations, voir Gestion de Docker en tant qu'utilisateur non superutilisateur.
  5. Après l'installation, veillez à démarrer Docker et vérifiez que Docker est correctement installé.
    Sur votre système Ubuntu , exécutez la commande suivante en tant que superutilisateur pour démarrer Docker:
    sudo service docker start

    Vous devez exécuter cette commande chaque fois que votre système WSL 2 redémarre ou vous pouvez la définir au niveau de démarrage du système d'exploitation, qui démarre et active Docker chaque fois que votre système WSL 2 redémarre.

  6. Installez Docker Compose version 2.x (testé sur les versions 2.23.0, 2.24 ). Pour plus d'informations sur Docker Compose, voir Présentation de Docker Compose et Installation de Docker Compose.
  7. Il est recommandé d'arrêter ou de désactiver les services d'application DB2®, WebSphere® Application Server,IBM WebSphere Liberty ou MQ qui s'exécutent sur votre système WSL 2 car ils peuvent consommer inutilement des ressources système et les numéros de port peuvent entrer en conflit avec l'environnement Docker Compose .
  8. Sur votre système WSL 2, ajoutez mqserver en tant que localhost dans votre fichier /etc/hosts . Cette étape doit être répétée chaque fois que le système WSL 2 redémarre. Il est recommandé d'automatiser cette étape pour qu'elle s'exécute au démarrage de votre système WSL 2.

Etape suivante

Gardez à l'esprit les points suivants lorsque vous configurez le kit d'outils de développement dans un environnement Windows WSL 2:
IMPORTANT :
  • Dans le contexte de la configuration du kit d'outils de développement dans un environnement Windows (WSL 2), partout où localhost est mentionné, vous devez utiliser l'adresse IP de votre système WSL 2. Vous pouvez obtenir l'adresse IP du système WSL 2 en exécutant la commande suivante:

    ip addr | grep -Ee 'inet.*eth0'

    Cette commande renvoie l'adresse IP au début de la sortie de cette commande. Cette adresse IP change chaque fois que votre système WSL 2 redémarre.

    Si vous souhaitez utiliser localhost au lieu de l'adresse IP dans l' URL utilisée pour consommer les services qui fonctionnent dans le système Ubuntu à partir de votre système Windows WSL2 ), vous devez transférer les ports pertinents sur lesquels ces services fonctionnent, tels que 80, 443, 1414, 9080, 9443, 50000, vers l'adresse IP de votre système WSL 2.

  • Il est recommandé d'extraire les fichiers du kit d'outils de développement dans votre répertoire /home/user/ afin que le répertoire devtoolkit_docker se trouve directement dans votre répertoire /home/user/ . Cela garantit également que votre kit d'outils de développement s'exécute sur le système de fichiers racine de votre système Ubuntu et non sur des unités ou des répertoires partagés avec Windows, tels que /mnt/c .

    Pour plus d'informations sur l'extraction du kit du développeur, voir Extraction du kit du développeur.

  • Une fois la configuration terminée, lors de l'exécution d'un script de shell ou de commandes à partir du répertoire /runtime/bin extrait de votre kit d'outils de développement, si vous obtenez des erreurs telles que set: Illegal option -o pipefail, préfixez vos commandes avec bash.

    Par exemple, vous devez entrer la commande bash ./agentserver.sh AgentServer au lieu de ./agentserver.sh AgentServer.