Conditions préalables à la mise en place d'une boîte à outils de développement conteneurisée sur Mac M1

L'installation du kit de développement est prise en charge sur Mac M1. Vous pouvez installer Docker en utilisant Colima ou Rancher Desktop.

IMPORTANT :
  • Si vous configurez le kit de développement avant la version 10.0.2409.2 sur Mac Mx, et si vous rencontrez des problèmes lors de l'extraction de l'image docker.io/ibmoms/mq-core_arm64:9.3.3.0 depuis Docker Hub, suivez les étapes suivantes pour résoudre le problème :
    1. Allez dans le répertoire compose/docker et ouvrez le fichier docker-compose.properties
    2. Recherchez MQ_IMAGE_ARM64=ibmoms/mq-core_arm64 et modifiez-le en MQ_IMAGE_ARM64=icr.io/cpopen/ibm-oms/mq-core
    3. Recherchez MQ_TAG_ARM64=9.3.3.0 et modifiez-le en MQ_TAG_ARM64=9.3.3.0_arm64
  • Si vous rencontrez un problème lors de la configuration de la boîte à outils du développeur, suivez les étapes suivantes :
    1. Naviguez jusqu'au fichier compose/docker/docker-compose.yml.
    2. Dans service: omruntime, ajoutez user: root avant la balise enviornment: comme illustré dans l'exemple de fichier suivant.
      services:
       omruntime:
        image: ${OM_IMAGE}:${OM_TAG}
        entrypoint: ''
        command: ["sleep","infinity"]
        user: root
        environment:
         - DUMMY_PATH_PROP=1

Pour installer Docker à l'aide de Rancher Desktop, voir la documentation de Rancher Desktop. Par défaut, Rancher Desktop utilise les ports 9080 et 9443. Avant d'exécuter l'installation DTK, assurez-vous de mettre à jour les propriétés AP_HTTP_PORT et AP_HTTPS_PORT pour utiliser d'autres ports disponibles. Pour plus d'informations, voir Remplacer les propriétés par défaut de docker compose.

Pour installer Docker à l'aide de Colima, suivez les étapes suivantes :

Procédure

  1. Installez Docker en utilisant Colima.
    1. Exécutez la commande suivante :
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
      touch ~/.zshrc
      
    2. Ajoutez la commande suivante à la fin de .zshrc.
      export PATH=/opt/homebrew/bin:$PATH
    3. Ouvrez le terminal et exécutez les commandes suivantes :
      1. source ~/.zshrc
      2. brew install colima docker docker-compose
    4. Lancez Colima en exécutant la commande suivante :
      Colima start --cpu 8 --memory 8 --disk 80
  2. Installez Docker Compose version 2.x qui est testé sur les versions 2.23.0 et 2.24 . Pour plus d'informations sur l'installation de Docker Compose, voir Vue d'ensemble de Docker Compose et Installer Docker Compose.
  3. Arrêtez ou désactivez tous les services d'application natifs DB2®, WebSphere Application Server, Liberty ou IBM MQ qui s'exécutent localement, car ces services peuvent utiliser des ressources système et les numéros de port peuvent entrer en conflit avec l'environnement Docker Compose.
  4. Sur la machine hôte, accédez au fichier /etc/hosts et ajoutez mqserver en tant que localhost.