Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'une fonctionnalité Argo CD à l'aide d'eksctl

Créez une fonctionnalité Argo CD sur votre cluster Amazon EKS à l'aide de eksctl.

Conditions préalables

Étape 1 : Création d'un rôle de capacité IAM

Créez un fichier de politique de confiance :

cat > argocd-trust-policy.json << 'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "capabilities.eks.amazonaws.com"
      },
      "Action": [
        "sts:AssumeRole",
        "sts:TagSession"
      ]
    }
  ]
}
EOF

Créez le rôle IAM :

aws iam create-role \
  --role-name ArgoCDCapabilityRole \
  --assume-role-policy-document file://argocd-trust-policy.json

Étape 2 : Obtenez votre AWS Configuration du centre d'identité

Obtenez l'ARN et l'ID utilisateur de votre instance Identity Center pour la configuration RBAC :

# Get your Identity Center instance ARN
aws sso-admin list-instances --query 'Instances[0].InstanceArn' --output text

# Get a user ID for admin access (replace 'your-username' with your Identity Center username)
aws identitystore list-users \
  --identity-store-id $(aws sso-admin list-instances --query 'Instances[0].IdentityStoreId' --output text) \
  --query 'Users[?UserName==`your-username`].UserId' --output text

Notez ces valeurs. Vous en aurez besoin à l'étape suivante.

(Facultatif) Configurer un point de terminaison privé

Par défaut, l'interface utilisateur et le point de terminaison de l'API Argo CD sont accessibles au public sur Internet. Si vous devez restreindre l'accès, vous pouvez configurer un point de terminaison VPC. Ceci est recommandé pour les environnements soumis à des exigences de sécurité réseau strictes.

Création d'un point de terminaison VPC pour les fonctionnalités EKS

Créez un point de terminaison VPC d'interface pour le service EKS Capabilities de votre VPC. Remplacez vpc-idsubnet-id-1 subnet-id-2,sg-id, et region-code par vos propres valeurs :

aws ec2 create-vpc-endpoint \
  --vpc-endpoint-type Interface \
  --service-name com.amazonaws.region-code.eks-capabilities \
  --vpc-id vpc-id \
  --subnet-ids subnet-id-1 subnet-id-2 \
  --security-group-ids sg-id \
  --region region-code
         

Vérifiez que le point de terminaison VPC est disponible

aws ec2 describe-vpc-endpoints \
  --vpc-endpoint-ids vpce-xxxxxxxx \
  --query 'VpcEndpoints[0].State' \
  --output text \
  --region region-code
         

Attendez que l'état apparaisse available avant de continuer.

Étape 3 : Création d'un fichier de configuration eksctl

Créez un fichier nommé argocd-capability.yaml avec le contenu suivant. Remplacez les valeurs d'espace réservé par le nom de votre cluster, la région du cluster, l'ARN du rôle IAM, l'ARN de l'instance Identity Center, la région du centre d'identité et l'ID utilisateur :

apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: my-cluster
  region: cluster-region-code

capabilities:
  - name: my-argocd
    type: ARGOCD
    roleArn: arn:aws:iam::111122223333:role/ArgoCDCapabilityRole
    deletePropagationPolicy: RETAIN
    configuration:
      argocd:
        awsIdc:
          idcInstanceArn: arn:aws:sso:::instance/ssoins-123abc
          idcRegion: idc-region-code
        rbacRoleMappings:
          - role: ADMIN
            identities:
              - id: 38414300-1041-708a-01af-5422d6091e34
                type: SSO_USER

Si vous avez configuré un point de terminaison VPC pour un accès privé, ajoutez la networkConfiguration section à la définition des fonctionnalités. Remplacez-le vpce-xxxxxxxx par l'ID de votre point de terminaison VPC :

apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: my-cluster
  region: cluster-region-code

capabilities:
  - name: my-argocd
    type: ARGOCD
    roleArn: arn:aws:iam::111122223333:role/ArgoCDCapabilityRole
    deletePropagationPolicy: RETAIN
    networkConfiguration:
      elasticNetworkInterfaces:
        vpcEndpointId: vpce-xxxxxxxx
    configuration:
      argocd:
        awsIdc:
          idcInstanceArn: arn:aws:sso:::instance/ssoins-123abc
          idcRegion: idc-region-code
        rbacRoleMappings:
          - role: ADMIN
            identities:
              - id: 38414300-1041-708a-01af-5422d6091e34
                type: SSO_USER

Étape 4 : Création de la fonctionnalité Argo CD

Appliquez le fichier de configuration :

eksctl create capability -f argocd-capability.yaml

La commande revient immédiatement, mais la fonctionnalité met un certain temps à être active.

Étape 5 : Vérifiez que la fonctionnalité est active

Vérifiez l'état des capacités. region-codeRemplacez-la par la AWS région dans laquelle se trouve votre cluster et my-cluster remplacez-la par le nom de votre cluster.

eksctl get capability \
  --region region-code \
  --cluster my-cluster \
  --name my-argocd

La fonctionnalité est prête lorsque l'état s'afficheACTIVE.

Étape 6 : Vérifier la disponibilité des ressources personnalisées

Une fois la fonctionnalité activée, vérifiez que les ressources personnalisées Argo CD sont disponibles dans votre cluster :

kubectl api-resources | grep argoproj.io

Vous devriez voir Application et répertorier les types de ApplicationSet ressources.

Étapes suivantes