Ajout d'hôtes AWS à Satellite

Vous pouvez créer votre emplacement IBM Cloud Satellite en utilisant des hôtes que vous avez ajoutés depuis le cloud Amazon Web Services (AWS).

Tous les hôtes que vous souhaitez ajouter doivent répondre aux exigences générales relatives aux hôtes, telles que les paquets RHEL 8 et la configuration réseau. Pour plus d'informations, voir Configuration requise de l'hôte.

Si vous souhaitez utiliser des hôtes Red Hat CoreOS (RHCOS) dans votre emplacement, fournissez votre fichier image Red Hat CoreOS à votre compte Google. Pour plus d'informations, consultez la section Importer une instance d' VM e sous forme d'image à l'aide de. Pour rechercher des images RHCOS, consultez la liste des images disponibles. Notez que vous devez utiliser au moins la version 4.9.

Avant de commencer, créez un emplacement Satellite.

1. Depuis la console Satellite, sélectionnez l'emplacement où vous souhaitez ajouter des hôtes AWS.

2. Récupérez le script d'enregistrement d'hôte que vous devez exécuter sur vos hôtes pour qu'ils soient visibles dans votre emplacement IBM Cloud Satellite.

   1. Dans l'onglet Hôtes, cliquez sur Connecter un hôte.
   2. Facultatif : Entrez les libellés d'hôte utilisés ultérieurement pour affecter automatiquement sur les hôtes aux services IBM Cloud prêts pour Satellite dans l'emplacement. Les libellés doivent être indiqués sous forme de paires clé-valeur et doivent correspondre à la demande du service. Les libellés courants incluent env=prod ou service=database. Par défaut, vos hôtes reçoivent les étiquettes memory cpu, os, et. Ajoutez d'autres étiquettes pour contrôler l'attribution automatique, telles que env=prod ou service=database.
   3. Entrez un nom de fichier pour votre script ou utilisez le nom généré automatiquement.
   4. Cliquez sur Télécharger un script pour générer et télécharger le script de l'hôte sur la machine locale. Notez que le jeton dans le script est une clé d'API, qui doit être traitée et protégée comme une information sensible.

3. RHEL uniquement Ouvrez le script d'enregistrement. Après la ligne API_URL, ajoutez une section pour extraire les packages RHEL requis avec le gestionnaire d'abonnements.

   # Enable AWS RHEL package updates
   yum update -y
   yum-config-manager --enable '*'
   yum repolist all
   yum install container-selinux -y
   echo "repos enabled"
   

4. Depuis le tableau de bord d' AWS EC2, accédez à Instances > Modèles de lancement.

5. Cliquez sur Create Launch template et entrez les détails du modèle comme suit.

   Pour obtenir un aperçu des options disponibles que vous pouvez spécifier dans votre modèle de lancement, consultez la documentation {: tip}AWS

   1. Entrez un nom pour votre modèle de lancement.
   2. Dans la section Amazon Machine Image (AMI), veillez à sélectionner un système d'exploitation Red Hat Enterprise Linux 8 pris en charge, que vous pouvez trouver en saisissant l'ID AMI. Vous pouvez faire correspondre les ID AMI et la version Red Hat Enterprise Linux appropriée en vous référant à la documentationRed Hat Enterprise Linux AMI Available on Amazon Web Services. Si vous créez un hôte Red Hat CoreOS , vous devez fournir l'image à AWS. Pour plus d'informations, consultez la section Importer une instance d' VM e sous forme d'image à l'aide de.
   3. Dans la section Instance type, sélectionnez l'un des types d'instance AWS pris en charge.
   4. Dans la section Paire de clés (connexion) , sélectionnez la clé .pem à utiliser pour vous connecter ultérieurement à vos machines. Si vous n'avez pas de clé .pem , créez-en une.
   5. Dans Network settings, sélectionnez Virtual Private Cloud (VPC) ainsi qu'un sous-réseau existant et un groupe de sécurité autorisant le trafic réseau, comme défini dans Paramètres de groupe de sécurité. Si vous ne disposez pas d'un sous-réseau ou d'un groupe de sécurité que vous voulez utiliser, créez-en un.
   6. Dans la section Storage (volumes), développez le volume racine par défaut et mettez à jour le volume d'amorçage avec une taille d'au moins 100 Go. Ajoutez un second disque avec une capacité d'au moins 100 Go. Pour plus d'informations sur les exigences de stockage, voir Espace de stockage de l'hôte et périphériques connectés.
   7. Développez Advanced details et accédez à la zone User Data.
   8. Entrez le script d'enregistrement d'hôte que vous avez modifié précédemment. Si vous ajoutez un hôte RHCOS, ajoutez le script Ignition.
   9. Cliquez sur Create launch template.

6. Dans le tableau de bord Launch Templates, localisez le modèle que vous avez créé.

7. Dans le menu Actions, sélectionnez Launch instance from template.

8. Entrez le nombre d'instances à créer et cliquez sur Launch instance from template.

9. Attendez que l'instance soit lancée. Au cours du lancement de votre instance, le script d'enregistrement s'exécute automatiquement. L'exécution de ce processus prend quelques minutes.

10. Surveillez la progression du script d'enregistrement.

    1. Depuis le tableau de bord EC2 Instances, récupérez l'adresse IP publique de votre instance.
    2. Connectez-vous à votre instance.

        ssh -i <key>.pem ec2-user@<public_IP_address>
        ```
    3. Vérifiez le statut du script d'enregistrement.
    ```sh {: pre}
        journalctl -f -u ibm-host-attach
        ```
    

11. Vérifiez que vos hôtes apparaissent dans l'onglet Hôtes de votre console Satellite. Tous les hôtes présentent le statut Health Ready lorsqu'une connexion à une machine peut être établie, et le statut ** dans la zone **StatutUnassigned car les hôtes ne sont pas encore affectés à votre plan de contrôle d'emplacement Satellite ou à un cluster Red Hat OpenShift on IBM Cloud.

12. Affectez vos hôtes AWS au plan de contrôle Satellite ou à un cluster Red Hat OpenShift on IBM Cloud.

Association manuelle d'instances d' AWS s à l'aide de l'interface de ligne de commande (CLI)

Vous pouvez utiliser AWS CII pour exécuter vos instances EC2 et les connecter à votre emplacement Satellite . Pour plus d'informations, voir aws ec2 run-instances command reference.

Exemple de commande permettant d'exécuter des instances EC2 AWS.

aws ec2 run-instances --count COUNT --instance-type INSTANCE-TYPE --launch-template LaunchTemplateName=AWS-LAUNCH-TEMPLATE --user-data file://ATTACH-SCRIPT-LOCATION

Types d'instance AWS

L'examen a suggéré des types d'instances AWS EC2 pour les hôtes IBM Cloud Satellite qui répondent aux exigences minimales d'hôte.

Paramètres des groupes de sécurité pour l' AWS

Configurez un groupe de sécurité pour vos hôtes VPC d' AWS afin de répondre aux exigences de mise en réseau des hôtes. Récupérez les identifiants de propriétaire, de groupe, d'utilisateur et de VPC à partir de vos ressources AWS.

L'exemple suivant présente un groupe de sécurité pour l' AWS, conforme aux exigences de mise en réseau des hôtes d' Satellite.

{
	"Description": "Security group for IBM Cloud Satellite hosts",
	"GroupName": "Satellite",
	"IpPermissions": [{
			"FromPort": 80,
			"IpProtocol": "tcp",
			"IpRanges": [{
				"CidrIp": "0.0.0.0/0"
			}],
			"Ipv6Ranges": [],
			"PrefixListIds": [],
			"ToPort": 80,
			"UserIdGroupPairs": []
		},
		{
			"FromPort": 30000,
			"IpProtocol": "tcp",
			"IpRanges": [{
				"CidrIp": "0.0.0.0/0"
			}],
			"Ipv6Ranges": [{
				"CidrIpv6": "::/0"
			}],
			"PrefixListIds": [],
			"ToPort": 32767,
			"UserIdGroupPairs": []
		},
		{
			"IpProtocol": "-1",
			"IpRanges": [],
			"Ipv6Ranges": [],
			"PrefixListIds": [],
			"UserIdGroupPairs": [{
				"GroupId": "<group_ID>",
				"UserId": "<user_ID>"
			}]
		},
		{
			"FromPort": 22,
			"IpProtocol": "tcp",
			"IpRanges": [{
				"CidrIp": "0.0.0.0/0"
			}],
			"Ipv6Ranges": [],
			"PrefixListIds": [],
			"ToPort": 22,
			"UserIdGroupPairs": []
		},
		{
			"FromPort": 30000,
			"IpProtocol": "udp",
			"IpRanges": [{
				"CidrIp": "0.0.0.0/0"
			}],
			"Ipv6Ranges": [{
				"CidrIpv6": "::/0"
			}],
			"PrefixListIds": [],
			"ToPort": 32767,
			"UserIdGroupPairs": []
		},
		{
			"FromPort": 443,
			"IpProtocol": "tcp",
			"IpRanges": [{
				"CidrIp": "0.0.0.0/0"
			}],
			"Ipv6Ranges": [{
				"CidrIpv6": "::/0"
			}],
			"PrefixListIds": [],
			"ToPort": 443,
			"UserIdGroupPairs": []
		}
	],
	"OwnerId": "<owner_ID>",
	"GroupId": "<group_ID>",
	"IpPermissionsEgress": [{
		"IpProtocol": "-1",
		"IpRanges": [{
			"CidrIp": "0.0.0.0/0"
		}],
		"Ipv6Ranges": [],
		"PrefixListIds": [],
		"UserIdGroupPairs": []
	}],
	"VpcId": "<vpc_ID>"
}

Pour plus d'informations, voir Contrôle du trafic vers les ressources à l'aide de groupes de sécurité dans la documentation AWS.

J'ai ajouté des hôtes à mon emplacement, que faire ensuite?

Maintenant que vous avez ajouté des hôtes à votre site, vous pouvez les affecter à votre plan de contrôle de site ou à vos services d' IBM Cloud.

1. Affectez des hôtes au plan de contrôle d'emplacement ou à vos IBM Cloud.
2. Créez un service IBM Cloud prêt pour Satellite, par exemple un cluster Red Hat OpenShift. Vous pouvez même enregistrer les clusters Red Hat OpenShift existants dans votre emplacement comme cibles de déploiement.
3. Gérez vos applications avec la configuration Satellite.
4. Créez les modèles de stockage de cluster Satellite.
5. Découvrez le composant Satellite Link et déterminez comment vous pouvez utiliser des noeuds finaux pour gérer le trafic réseau entre l'emplacement et IBM Cloud.

Besoin d'aide ? Consultez la rubrique Obtenir de l'aide où vous trouverez des informations sur l'état du cloud, les problèmes et la journalisation; comment contacter le support; et comment définir vos préférences de notification par e-mail pour les éléments liés à la plateforme d' IBM Cloud.