Ayude a mejorar esta página

Para contribuir a esta guía del usuario, elija el enlace Edit this page on GitHub que se encuentra en el panel derecho de cada página.

Creación de una capacidad de Argo CD mediante eksctl

Cree una capacidad de Argo CD en su clúster de Amazon EKS mediante eksctl.

Requisitos previos

Paso 1: creación de un rol de capacidad de IAM

Cree un archivo de política de confianza:

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

Cree el rol de IAM:

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

Paso 2: obtención de la configuración de AWS Identity Center

Obtenga el ARN y el ID de usuario de su instancia de Identity Center para la configuración de 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

Anote estos valores, ya que los necesitará en el siguiente paso.

(Opcional) Configuración de un punto de conexión privado

De forma predeterminada, la interfaz de usuario de Argo CD y el punto de conexión de la API son accesibles públicamente a través de Internet. Si necesita restringir el acceso, puede configurar un punto de conexión de VPC. Esta opción se recomienda para entornos con requisitos de seguridad de red estrictos.

Creación de un punto de conexión de VPC para capacidades de EKS

Cree un punto de conexión de VPC de interfaz para el servicio de capacidades de EKS en la VPC. Sustituya vpc-id, subnet-id-1 subnet-id-2, sg-id y region-code por sus propios valores:

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
         

Verificación de que el punto de conexión de VPC esté disponible

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

Espere a que aparezca el estado available antes de continuar.

Paso 3: creación de un archivo de configuración de eksctl

Cree un archivo llamado argocd-capability.yaml con el siguiente contenido. Sustituya los valores de marcador de posición por el nombre del clúster, la región del clúster, el ARN del rol de IAM, el ARN de la instancia de Identity Center, la región de Identity Center y el ID de usuario:

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 configuró un punto de conexión de VPC para el acceso privado, agregue la sección networkConfiguration a la definición de la capacidad. Sustituya vpce-xxxxxxxx por el ID de punto de conexión de 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

Paso 4: creación de la capacidad de Argo CD

Aplique el archivo de configuración:

eksctl create capability -f argocd-capability.yaml

El comando vuelve inmediatamente, pero la capacidad tarda algún tiempo en activarse.

Paso 5: comprobación de la activación de la capacidad

Compruebe el estado de la capacidad. Reemplace region-code por la región de AWS donde creó el clúster y my-cluster por el nombre de su clúster.

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

La capacidad estará lista cuando aparezca el estado ACTIVE.

Paso 6: comprobación de la disponibilidad de los recursos personalizados

Una vez que la capacidad esté activa, compruebe que los recursos personalizados de Argo CD estén disponibles en el clúster:

kubectl api-resources | grep argoproj.io

Debería ver todos los tipos de recursos Application y ApplicationSet en la lista.

Siguientes pasos