Ajudar a melhorar esta página

Para contribuir com este guia de usuário, escolha o link Editar esta página no GitHub, disponível no painel direito de cada página.

Criação de uma funcionalidade do Argo CD por meio do eksctl

Crie uma funcionalidade do Argo CD no cluster do Amazon EKS usando a ferramenta eksctl.

Pré-requisitos

Etapa 1: criação de um perfil de funcionalidade do IAM

Crie um arquivo de política de confiança:

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

Crie o perfil do IAM:

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

Etapa 2: obtenção da configuração do Centro de Identidade da AWS

Obtenha o ARN da instância do Centro de Identidade e o ID do usuário para a configuração 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 esses valores. Você precisará deles na próxima etapa.

(Opcional) Configurar um endpoint privado

Por padrão, a interface do usuário e o endpoint de API do Argo CD são acessíveis publicamente pela internet. Se você precisar restringir o acesso, poderá configurar um endpoint da VPC. Recomendado para ambientes com requisitos rígidos de segurança de rede.

Criar um endpoint da VPC para Capacidades do EKS

Crie um endpoint da VPC de interface para o serviço Capacidades do EKS em sua VPC. Substitua vpc-id, subnet-id-1 subnet-id-2, sg-id e region-code pelos seus próprios 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
         

Verifique se o endpoint da VPC está disponível

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

Aguarde até que o estado apareça como available antes de continuar.

Etapa 3: criação de um arquivo de configuração do eksctl

Crie um arquivo chamado argocd-capability.yaml com o conteúdo a seguir. Substitua os valores com espaços reservados pelo nome do seu cluster, região, ARN do perfil do IAM, ARN da instância do Centro de Identidade, região do Centro de Identidade e ID do usuário:

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

Se você configurou um endpoint da VPC para acesso privado, adicione a seção networkConfiguration à definição de capacidade. Substitua vpce-xxxxxxxx pelo ID do seu endpoint da 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

Etapa 4: criação da funcionalidade do Argo CD

Aplique o arquivo de configuração:

eksctl create capability -f argocd-capability.yaml

O comando é executado de forma imediata, mas a funcionalidade demora algum tempo para se tornar ativa.

Etapa 5: verificação da ativação da funcionalidade

Verifique o status da funcionalidade. Substitua region-code pela região AWS em que seu cluster se encontra e substitua my-cluster pelo nome do seu cluster.

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

A funcionalidade estará pronta assim que o status mostrar ACTIVE.

Etapa 6: verificação da disponibilidade de recursos personalizados

Após a funcionalidade estar ativa, verifique se os recursos personalizados do Argo CD estão disponíveis no cluster:

kubectl api-resources | grep argoproj.io

Os tipos de recursos Application e ApplicationSet devem aparecer na lista apresentada.

Próximas etapas