Exécution de votre agent de connecteur en tant que service en mode d'essaim Docker pour la haute disponibilité
Utilisez le mode Swarm d' Docker pour exécuter un cluster comprenant jusqu'à 3 conteneurs sur plusieurs machines afin d'assurer la haute disponibilité de l'agent Satellite Connector.
Pour configurer les connecteurs d' Satellite, vous devez disposer d'un accès Administrateur au service Satellite dans les politiques d'accès IAM.
- Satellite Le Connecteur traite tous les agents connectés à un Connecteur de manière égale.
- Les sessions TCP sont réparties selon le principe du round robin entre tous les agents.
- Conformément aux recommandations relatives au connecteur d' IBM, utilisez au moins 3 agents à des fins de redondance. Cela rend le service Connecteur d' Satellite s plus fiable et aucun supplément n'est facturé pour les agents supplémentaires. Sous Windows, cela implique d'utiliser plusieurs hôtes Windows.
- Si vous utilisez des conteneurs, assurez-vous qu'ils ne se trouvent pas tous sur la même VM ou le même matériel, car cette configuration n'est pas redondante.
- Pour les charges de travail nécessitant une bande passante élevée, IBM recommande d’utiliser au moins 6 agents, car cela permet de couvrir davantage d’hôtes et d’augmenter la bande passante.
- Satellite Le connecteur prend en charge jusqu’à 9 agents par connecteur, mais IBM ne recommande pas cette configuration car les conteneurs et les machines virtuelles sont éphémères et il peut y avoir un délai avant de remarquer qu’un conteneur a disparu et qu’un nouveau tente de se connecter. Laissez plutôt au moins 3 emplacements libres pour permettre l'arrêt et le démarrage des conteneurs et des machines virtuelles.
-
Créez un fichier de composition d'agent Satellite Connector nommé
connector-agent.yamlsur votre système Swarm Manager et copiez-y le contenu suivant. Si vous avez plusieurs environnements, vous devez créer plusieurs fichiers de configuration et les nommer par environnement. Par exemple, créez un siteconnector-agent-prod.yamlpour la production et un siteconnector-agent-staging.yamlpour la mise à disposition. Ensuite, incluez l'ID du connecteur que vous souhaitez utiliser pour chaque environnement dans le fichier correspondant.version: '3.9' services: agent: image: icr.io/ibm/satellite-connector/satellite-connector-agent:latest environment: - SATELLITE_CONNECTOR_ID=/satellite-connector-id - SATELLITE_CONNECTOR_IAM_APIKEY=/run/secrets/satellite-connector-iam-apikey - SATELLITE_CONNECTOR_TAGS={{.Node.Hostname}} # You also can add other details in this field. For example, SATELLITE_CONNECTOR_TAGS="Some text" deploy: replicas: 3 restart_policy: condition: any update_config: parallelism: 2 delay: 20s failure_action: rollback order: start-first resources: limits: cpus: '0.40' memory: 500M reservations: cpus: '0.04' memory: 200M configs: - source: satellite-connector-id uid: '1000' gid: '1000' mode: 0400 - source: satellite-connector-region uid: '1000' gid: '1000' mode: 0400 secrets: - source: satellite-connector-iam-apikey uid: '1000' gid: '1000' mode: 0400 logging: driver: "json-file" options: max-size: ${JSON_FILE_MAX_SIZE:-1m} max-file: ${JSON_FILE_MAX_FILE:-10} configs: satellite-connector-id: external: true satellite-connector-region: external: true secrets: satellite-connector-iam-apikey: external: true networks: default: external: true name: bridge -
Créez une configuration Docker avec l'ID de connecteur Satellite.
printf <satellite connector id value> | docker config create satellite-connector-id - -
Créez une configuration Docker avec la région de connecteur Satellite.
printf <satellite connector region value> | docker config create satellite-connector-region - -
Créez un secret Docker avec votre clé d'API IAM.
printf <Your IAM API key> | docker secret create satellite-connector-iam-apikey -
Par défaut, le fichier Swarm compose définit la variable d'environnement SATELLITE_CONNECTOR_TAGS sur le nom d'hôte du noeud Swarm. Vous pouvez ajuster cette valeur en fonction de vos besoins dans le fichier de composition. En outre,
le nombre de répliques est défini sur 3 par défaut. Vous pouvez réduire ce nombre, mais un maximum de 3 répliques est pris en charge.
- Déployez le service d'agent de connecteur Satellite.
- Assurez-vous d'être connecté à IBM Cloud® Container Registry à l'aide de l'interface de ligne de commande
ibmcloud cr loginou de votre clé d'APIdocker login -u iamapikey -p <your apikey> icr.io. - Déployez la pile.
docker stack deploy --compose-file satellite-connector-agent.yaml --with-registry-auth satellite_connector
- Assurez-vous d'être connecté à IBM Cloud® Container Registry à l'aide de l'interface de ligne de commande
- Vérifiez que le service de l'agent du connecteur Satellite est en cours d'exécution.
docker service ps satellite_connector_agent