**Unterstützung für die Verbesserung dieser Seite beitragen** 

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Um zu diesem Benutzerhandbuch beizutragen, wählen Sie den GitHub ** Link Diese Seite ** bearbeiten unter, der sich im rechten Bereich jeder Seite befindet.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erstellen Sie eine Argo-CD-Funktion mit eksctl
<a name="argocd-create-eksctl"></a>

Erstellen Sie mit eksctl eine Argo-CD-Funktion auf Ihrem Amazon EKS-Cluster.

**Anmerkung**  
Für die folgenden Schritte ist eine eksctl-Version oder höher erforderlich. `0.215.0` Führen Sie den Befehl aus, um Ihre Version zu überprüfen. `eksctl version`

## Voraussetzungen
<a name="_prerequisites"></a>
+  ** AWS Identity Center konfiguriert ** — Argo CD benötigt AWS Identity Center für die Authentifizierung. Lokale Benutzer werden nicht unterstützt. Wenn Sie AWS Identity Center nicht eingerichtet haben, finden Sie unter [ Erste Schritte mit AWS Identity Center ](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) eine Identity Center-Instanz und Benutzer [ hinzufügen und Gruppen hinzufügen, [ um Benutzer ](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html) und ](https://docs.aws.amazon.com/singlesignon/latest/userguide/addusers.html) Gruppen für den Argo-CD-Zugriff zu erstellen.
+  **Mindestens ein Benutzer oder eine Gruppe in AWS Identity Center ** — Sie müssen mindestens einen Benutzer oder eine Gruppe in Ihrer Identity Center-Instanz konfiguriert haben, um Argo CD RBAC-Rollenzuordnungen zuzuweisen und Zugriff auf die Argo CD-Benutzeroberfläche zu gewähren.

## Schritt 1: Erstellen Sie eine IAM-Capability-Rolle
<a name="_step_1_create_an_iam_capability_role"></a>

Erstellen Sie eine Vertrauensrichtliniendatei:

```
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
```

Erstellen Sie die IAM-Rolle:

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

**Anmerkung**  
Für diese grundlegende Einrichtung sind keine zusätzlichen IAM-Richtlinien erforderlich. Wenn Sie Secrets Manager für Repository-Anmeldeinformationen oder verwenden möchten CodeConnections, müssen Sie der Rolle Berechtigungen hinzufügen. Beispiele für IAM-Richtlinien und Anleitungen zur Konfiguration finden Sie unter [Anwendungsgeheimnisse mit AWS Secrets Manager verwalten](integration-secrets-manager.md) und[Connect zu Git-Repositorys her mit AWS CodeConnections](integration-codeconnections.md).

## Schritt 2: Holen Sie sich Ihre AWS Konfiguration des Identity Centers
<a name="step_2_get_your_shared_aws_identity_center_configuration"></a>

Rufen Sie den ARN und die Benutzer-ID Ihrer Identity Center-Instanz für die RBAC-Konfiguration ab:

```
# 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
```

Notieren Sie sich diese Werte — Sie benötigen sie im nächsten Schritt.

## (Optional) Konfigurieren Sie einen privaten Endpunkt
<a name="_optional_configure_a_private_endpoint"></a>

Standardmäßig sind die Argo CD-Benutzeroberfläche und der API-Endpunkt öffentlich über das Internet zugänglich. Wenn Sie den Zugriff einschränken müssen, können Sie einen VPC-Endpunkt konfigurieren. Dies wird für Umgebungen mit strengen Netzwerksicherheitsanforderungen empfohlen.

### Erstellen Sie einen VPC-Endpunkt für EKS-Funktionen
<a name="_create_a_vpc_endpoint_for_eks_capabilities"></a>

Erstellen Sie einen Schnittstellen-VPC-Endpunkt für den EKS-Capabilities-Dienst in Ihrer VPC. Ersetzen Sie{{vpc-id}}, {{subnet-id-1 subnet-id-2}}{{sg-id}}, und {{region-code}} durch Ihre eigenen Werte:

```
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}}
```

**Anmerkung**  
Die Subnetze sollten sich aus Gründen der Hochverfügbarkeit in verschiedenen Availability Zones befinden.
Die Sicherheitsgruppe muss eingehenden HTTPS-Verkehr (Port 443) von den Netzwerken zulassen, die auf die Argo CD-Benutzeroberfläche und -API zugreifen müssen.
Notieren Sie sich die VPC-Endpunkt-ID, die von diesem Befehl zurückgegeben wird. Sie benötigen sie, wenn Sie die Funktion erstellen.

### Stellen Sie sicher, dass der VPC-Endpunkt verfügbar ist
<a name="_verify_the_vpc_endpoint_is_available"></a>

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

Warten Sie, bis der Status angezeigt wird, `available` bevor Sie fortfahren.

## Schritt 3: Erstellen Sie eine eksctl-Konfigurationsdatei
<a name="_step_3_create_an_eksctl_configuration_file"></a>

Erstellen Sie eine Datei mit dem Namen `argocd-capability.yaml` und dem folgenden Inhalt. Ersetzen Sie die Platzhalterwerte durch den Namen Ihres Clusters, die Cluster-Region, den IAM-Rollen-ARN, den Identity Center-Instanz-ARN, die Identity Center-Region und die Benutzer-ID:

```
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
```

**Anmerkung**  
Sie können den RBAC-Zuordnungen mehrere Benutzer oder Gruppen hinzufügen. Verwenden Sie für Gruppen die Gruppen-ID `type: SSO_GROUP` und geben Sie sie an. Verfügbare Rollen sind `ADMIN``EDITOR`, und`VIEWER`.

Wenn Sie einen VPC-Endpunkt für den privaten Zugriff konfiguriert haben, fügen Sie den `networkConfiguration` Abschnitt zur Funktionsdefinition hinzu. Ersetzen Sie ihn {{vpce-xxxxxxxx}} durch Ihre VPC-Endpunkt-ID:

```
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
```

**Anmerkung**  
Wenn der private Endpunkt aktiviert ist, sind die Benutzeroberfläche und die API von Argo CD nur über den VPC-Endpunkt zugänglich. Benutzer müssen mit der VPC (oder einem Peering-Netzwerk) verbunden sein, um auf die Argo-CD-Schnittstelle zugreifen zu können.

## Schritt 4: Erstellen Sie die Argo-CD-Funktion
<a name="_step_4_create_the_argo_cd_capability"></a>

Wenden Sie die Konfigurationsdatei an:

```
eksctl create capability -f argocd-capability.yaml
```

Der Befehl kehrt sofort zurück, aber es dauert einige Zeit, bis die Funktion aktiv wird.

## Schritt 5: Stellen Sie sicher, dass die Funktion aktiv ist
<a name="_step_5_verify_the_capability_is_active"></a>

Überprüfen Sie den Status der Fähigkeit. {{region-code}}Ersetzen Sie durch die AWS Region, in der sich Ihr Cluster befindet, und {{my-cluster}} ersetzen Sie es durch den Namen Ihres Clusters.

```
eksctl get capability \
  --region {{region-code}} \
  --cluster {{my-cluster}} \
  --name my-argocd
```

Die Funktion ist bereit, wenn der Status angezeigt wird`ACTIVE`.

## Schritt 6: Stellen Sie sicher, dass benutzerdefinierte Ressourcen verfügbar sind
<a name="_step_6_verify_custom_resources_are_available"></a>

Nachdem die Funktion aktiv ist, stellen Sie sicher, dass benutzerdefinierte Argo CD-Ressourcen in Ihrem Cluster verfügbar sind:

```
kubectl api-resources | grep argoproj.io
```

Sie sollten alle `ApplicationSet` Ressourcentypen aufgelistet sehen`Application`.

## Nächste Schritte
<a name="_next_steps"></a>
+  [Arbeiten mit Argo CD](working-with-argocd.md)- Erfahren Sie, wie Sie Argo CD-Anwendungen erstellen und verwalten
+  [Überlegungen zu Argo CD](argocd-considerations.md)- Konfigurieren Sie SSO und Multi-Cluster-Zugriff
+  [Arbeiten mit Kapazitätsressourcen](working-with-capabilities.md)- Verwalten Sie Ihre Argo CD-Funktionsressource