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.
# Konfiguration und Ausführung von Amazon EKS Anywhere auf Snowball Edge-Geräten
Gehen Sie wie folgt vor, um Amazon EKS Anywhere auf Ihren Snowball Edge-Geräten zu konfigurieren und zu starten. Um Amazon EKS Anywhere dann für den Betrieb auf getrennten Geräten zu konfigurieren, führen Sie zusätzliche Verfahren durch, bevor Sie diese Geräte vom externen Netzwerk trennen. Weitere Informationen finden Sie unter [Konfiguration von Amazon EKS Anywhere on AWS Snow für den Betrieb ohne Internetverbindung](configure-disconnected.md).
**Topics**
+ [Ersteinrichtung für Amazon EKS Anywhere auf Snowball Edge](#initial-setup)
+ [Automatisches Konfigurieren und Ausführen von Amazon EKS Anywhere auf Snowball Edge-Geräten](#auto-eksa-configuration)
+ [Manuelles Konfigurieren und Ausführen von Amazon EKS Anywhere auf Snowball Edge-Geräten](#manual-eksa-configuration)
## Ersteinrichtung für Amazon EKS Anywhere auf Snowball Edge
Führen Sie die Ersteinrichtung auf jedem Snowball Edge-Gerät durch, indem Sie das Gerät mit Ihrem lokalen Netzwerk verbinden, den Snowball Edge-Client herunterladen, Anmeldeinformationen abrufen und das Gerät entsperren.
**Führen Sie die Ersteinrichtung durch**
1. Laden Sie den Snowball Edge-Client herunter und installieren Sie ihn. Weitere Informationen finden Sie unter [Den Snowball Edge-Client herunterladen und installieren](using-client-commands.md#download-the-client).
1. Connect das Gerät mit Ihrem lokalen Netzwerk. Weitere Informationen finden Sie unter [Einen Snowball Edge mit Ihrem lokalen Netzwerk verbinden](getting-started.md#getting-started-connect).
1. Holen Sie sich Anmeldeinformationen, um Ihr Gerät zu entsperren. Weitere Informationen finden Sie unter [Anmeldeinformationen für den Zugriff auf Snowball Edge abrufen](getting-started.md#get-credentials).
1. Entsperren Sie das Gerät. Weitere Informationen finden Sie unter [Den Snowball Edge freischalten](unlockdevice.md). Sie können auch ein Skripttool verwenden, anstatt Geräte manuell zu entsperren. Siehe [Geräte entsperren.](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/setup-tools#Unlock-devices)
## Automatisches Konfigurieren und Ausführen von Amazon EKS Anywhere auf Snowball Edge-Geräten
Sie können Beispielskripttools verwenden, um die Umgebung einzurichten und eine Amazon EKS Anywhere Anywhere-Admin-Instance auszuführen, oder Sie können dies manuell tun. Informationen zur Verwendung der Skripttools finden Sie unter [Geräte entsperren und Umgebung für Amazon EKS Anywhere einrichten](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/setup-tools#Unlock-devices-and-setup-envorinment-for-EKS-Anywhere). Wenn Sie nach der Einrichtung der Umgebung und der Ausführung der Amazon EKS Anywhere-Admin-Instanz Amazon EKS Anywhere so konfigurieren müssen, dass es auf dem Snowball Edge-Gerät funktioniert, wenn keine Verbindung zum Netzwerk besteht, finden Sie weitere Informationen unter. [Konfiguration von Amazon EKS Anywhere on AWS Snow für den Betrieb ohne Internetverbindung](configure-disconnected.md) Andernfalls lesen Sie unter [Cluster auf Snowball Edge-Geräten erstellen und verwalten](maintain-eks-a-clusters-snow.md) weiter.
Informationen zum manuellen Einrichten der Umgebung und zum Ausführen einer Amazon EKS Anywhere Anywhere-Admin-Instanz finden Sie unter[Manuelles Konfigurieren und Ausführen von Amazon EKS Anywhere auf Snowball Edge-Geräten](#manual-eksa-configuration).
## Manuelles Konfigurieren und Ausführen von Amazon EKS Anywhere auf Snowball Edge-Geräten
Bevor Sie Amazon EKS Anywhere auf einem Snowball Edge-Gerät konfigurieren, richten Sie ein Profil für den Snowball Edge-Client ein. Weitere Informationen finden Sie unter [Konfiguration und Verwendung des Snowball Edge-Clients](using-client-commands.md).
**Topics**
+ [Einen lokalen Amazon EKS Anywhere IAM-Benutzer erstellen](#create-role)
+ [(Optional) Erstellen und importieren Sie einen Secure Shell-Schlüssel auf einem Snowball Edge](#create-ssh-key)
+ [Führen Sie eine Amazon EKS Anywhere Anywhere-Admin-Instanz auf einem Snowball Edge aus und übertragen Sie Anmelde- und Zertifikatsdateien darauf](#start-config-eksa-admin-instance)
### Einen lokalen Amazon EKS Anywhere IAM-Benutzer erstellen
Um bewährte Sicherheitsmethoden zu erhalten, erstellen Sie einen lokalen IAM-Benutzer für Amazon EKS Anywhere auf dem Snowball Edge-Gerät. Sie können dies manuell mithilfe der folgenden Verfahren tun.
**Anmerkung**
Tun Sie dies für jedes Snowball Edge-Gerät, das Sie verwenden.
#### Erstellen Sie einen lokalen Benutzer auf dem Snowball Edge
Verwenden Sie den `create-user` Befehl, um den Amazon EKS Anywhere IAM-Benutzer zu erstellen.
```
aws iam create-user --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name
{
"User": {
"Path": "/",
"UserName": "eks-a-user",
"UserId": "AIDACKCEVSQ6C2EXAMPLE",
"Arn": "arn:aws:iam::123456789012:user/eks-a-user",
"CreateDate": "2022-04-06T00:13:35.665000+00:00"
}
}
```
#### Erstellen Sie eine Richtlinie für den lokalen Benutzer auf dem Snowball Edge
Erstellen Sie ein Richtliniendokument, verwenden Sie es, um eine IAM-Richtlinie zu erstellen, und hängen Sie diese Richtlinie an den lokalen Benutzer von Amazon EKS Anywhere an.
**Um ein Richtliniendokument zu erstellen und es an den lokalen Benutzer von Amazon EKS Anywhere anzuhängen**
1. Erstellen Sie ein Richtliniendokument und speichern Sie es auf Ihrem Computer. Kopieren Sie die unten stehende Richtlinie in das Dokument.
------
#### [ JSON ]
****
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"snowball-device:DescribeDevice",
"snowball-device:CreateDirectNetworkInterface",
"snowball-device:DeleteDirectNetworkInterface",
"snowball-device:DescribeDirectNetworkInterfaces",
"snowball-device:DescribeDeviceSoftware"
],
"Resource": ["*"]
},
{
"Effect": "Allow",
"Action": [
"ec2:RunInstances",
"ec2:DescribeInstances",
"ec2:TerminateInstances",
"ec2:ImportKeyPair",
"ec2:DescribeKeyPairs",
"ec2:DescribeInstanceTypes",
"ec2:DescribeImages",
"ec2:DeleteTags"
],
"Resource": ["*"]
}
]
}
```
------
1. Verwenden Sie den `create-policy` Befehl, um eine IAM-Richtlinie auf der Grundlage des Richtliniendokuments zu erstellen. Der Wert des `--policy-document` Parameters sollte den absoluten Pfad zur Richtliniendatei verwenden. Beispiel: `file:///home/user/policy-name.json`
```
aws iam create-policy --policy-name policy-name --policy-document file:///home/user/policy-name.json --endpoint http://snowball-ip:6078 --profile profile-name
{
"Policy": {
"PolicyName": "policy-name",
"PolicyId": "ANPACEMGEZDGNBVGY3TQOJQGEZAAAABP76TE5MKAAAABCCOTR2IJ43NBTJRZBU",
"Arn": "arn:aws:iam::123456789012:policy/policy-name",
"Path": "/",
"DefaultVersionId": "v1",
"AttachmentCount": 0,
"IsAttachable": true,
"CreateDate": "2022-04-06T04:46:56.907000+00:00",
"UpdateDate": "2022-04-06T04:46:56.907000+00:00"
}
}
```
1. Verwenden Sie den `attach-user-policy` Befehl, um die IAM-Richtlinie an den lokalen Benutzer von Amazon EKS Anywhere anzuhängen.
```
aws iam attach-user-policy --policy-arn policy-arn --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name
```
#### Erstellen Sie einen Zugriffsschlüssel und eine Anmeldeinformationsdatei auf dem Snowball Edge
Erstellen Sie einen Zugriffsschlüssel für den lokalen Amazon EKS Anywhere IAM-Benutzer. Erstellen Sie anschließend eine Anmeldeinformationsdatei und fügen Sie darin die Werte des `AccessKeyId` lokalen Benutzers ein. `SecretAccessKey` Die Anmeldeinformationsdatei wird später von der Amazon EKS Anywhere Anywhere-Admin-Instanz verwendet.
1. Verwenden Sie den `create-access-key` Befehl, um einen Zugriffsschlüssel für den lokalen Amazon EKS Anywhere Anywhere-Benutzer zu erstellen.
```
aws iam create-access-key --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name
{
"AccessKey": {
"UserName": "eks-a-user",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"Status": "Active",
"SecretAccessKey": "RTT/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"CreateDate": "2022-04-06T04:23:46.139000+00:00"
}
}
```
1. Erstellen Sie eine Anmeldeinformationsdatei. Speichern Sie darin die `SecretAccessKey` Werte `AccessKeyId` und im folgenden Format.
```
[snowball-ip]
aws_access_key_id = ABCDEFGHIJKLMNOPQR2T
aws_secret_access_key = AfSD7sYz/TBZtzkReBl6PuuISzJ2WtNkeePw+nNzJ
region = snow
```
**Anmerkung**
Wenn Sie mit mehreren Snowball Edge-Geräten arbeiten, spielt die Reihenfolge der Anmeldeinformationen in der Datei keine Rolle, aber die Anmeldeinformationen für alle Geräte müssen sich in einer Datei befinden.
#### Erstellen Sie eine Zertifikatsdatei für die Admin-Instanz auf dem Snowball Edge
Die Amazon EKS Anywhere Anywhere-Admin-Instance benötigt die Zertifikate der Snowball Edge-Geräte, um auf ihnen ausgeführt werden zu können. Erstellen Sie eine Zertifikatsdatei, die das Zertifikat für den Zugriff auf Snowball Edge-Geräte zur späteren Verwendung durch die Amazon EKS Anywhere Anywhere-Admin-Instanz enthält.
**Um eine Zertifikatsdatei zu erstellen**
1. Verwenden Sie den `list-certificates` Befehl, um Zertifikate für jedes Snowball Edge-Gerät abzurufen, das Sie verwenden möchten.
```
PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge list-certificates --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
{
"Certificates" : [ {
"CertificateArn" : "arn:aws:snowball-device:::certificate/xxx",
"SubjectAlternativeNames" : [ "ID:JID-xxx" ]
} ]
}
```
1. Verwenden Sie den Wert von `CertificateArn` als Wert für den `--certificate-arn` Parameter des `get-certificate` Befehls.
```
PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge get-certificate --certificate-arn ARN --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
```
1. Erstellen Sie eine Gerätezertifikatsdatei. Fügen Sie die Ausgabe von `get-certificate` in die Zertifikatsdatei ein. Im Folgenden finden Sie ein Beispiel für das Speichern der Ausgabe.
**Anmerkung**
Wenn Sie mit mehreren Snowball Edge-Geräten arbeiten, spielt die Reihenfolge der Anmeldeinformationen in der Datei keine Rolle, aber die Anmeldeinformationen für alle Geräte müssen sich in einer Datei befinden.
```
-----BEGIN CERTIFICATE-----
ZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGUgZWtzYSBzbm93IHRlc3QgY2VydGlm
aWNhdGVla3NhIHNub3cgdGVzdCBjZXJ0aWZpY2F0ZWVrc2Egc25vdyB0ZXN0IGNl
cnRpZmljYXRlZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGVla3NhIHNub3cgdGVz
dCBjZXJ0aWZpY2F0ZQMIIDXDCCAkSgAwIBAgIJAISM0nTVmbj+MA0GCSqGSIb3DQ
...
-----END CERTIFICATE-----
```
1. Wiederholen Sie [Einen lokalen Amazon EKS Anywhere IAM-Benutzer erstellen](#create-role) den Vorgang, um auf allen Snowball Edge-Geräten einen lokalen IAM-Benutzer für Amazon EKS Anywhere zu erstellen.
### (Optional) Erstellen und importieren Sie einen Secure Shell-Schlüssel auf einem Snowball Edge
Verwenden Sie dieses optionale Verfahren, um einen Secure Shell (SSH) -Schlüssel für den Zugriff auf alle Amazon EKS Anywhere Anywhere-Node-Instances zu erstellen und den öffentlichen Schlüssel auf alle Snowball Edge-Geräte zu importieren. Bewahren Sie diese Schlüsseldatei auf und sichern Sie sie.
Wenn Sie dieses Verfahren überspringen, erstellt und importiert Amazon EKS Anywhere bei Bedarf automatisch einen SSH-Schlüssel. Dieser Schlüssel wird auf der Admin-Instanz in `${PWD}/${CLUSTER_NAME}/eks-a-id_rsa` gespeichert.
**Erstellen Sie einen SSH-Schlüssel und importieren Sie ihn in die Amazon EKS Anywhere Anywhere-Instance**
1. Verwenden Sie den `ssh-keygen` Befehl, um einen SSH-Schlüssel zu generieren.
```
ssh-keygen -t rsa -C "key-name" -f path-to-key-file
```
1. Verwenden Sie den `import-key-pair` Befehl, um den Schlüssel von Ihrem Computer auf das Snowball Edge-Gerät zu importieren.
**Anmerkung**
Der Wert des `key-name` Parameters muss identisch sein, wenn Sie den Schlüssel auf alle Geräte importieren.
```
aws ec2 import-key-pair --key-name key-name --public-key-material fileb:///path/to/key-file --endpoint http://snowball-ip:8008 --profile profile-name
{
"KeyFingerprint": "5b:0c:fd:e1:a0:69:05:4c:aa:43:f3:3b:3e:04:7f:51",
"KeyName": "default",
"KeyPairId": "s.key-85edb5d820c92a6f8"
}
```
### Führen Sie eine Amazon EKS Anywhere Anywhere-Admin-Instanz auf einem Snowball Edge aus und übertragen Sie Anmelde- und Zertifikatsdateien darauf
#### Führen Sie eine Amazon EKS Anywhere Anywhere-Admin-Instanz auf einem Snowball Edge aus
Gehen Sie wie folgt vor, um eine Amazon EKS Anywhere Anywhere-Admin-Instance manuell auszuführen, ein Virtual Network Interface (VNI) für die Admin-Instance zu konfigurieren, den Status der Instance zu überprüfen, einen SSH-Schlüssel zu erstellen und damit eine Verbindung zur Admin-Instance herzustellen. Sie können ein Beispielskripttool verwenden, um die Erstellung einer Amazon EKS Anywhere Anywhere-Admin-Instance und die Übertragung von Anmelde- und Zertifikatsdateien auf diese Instance zu automatisieren. Weitere Informationen finden [Sie unter Amazon EKS Anywhere Anywhere-Admin-Instanz erstellen](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/setup-tools#Create-EKS-Anywhere-admin-instance). Nachdem das Skripttool abgeschlossen ist, können Sie per SSH auf die Instance zugreifen und Cluster erstellen, indem Sie auf [Cluster auf Snowball Edge-Geräten erstellen und verwalten](maintain-eks-a-clusters-snow.md) verweisen. Wenn Sie die Amazon EKS Anywhere Anywhere-Instance manuell einrichten möchten, gehen Sie wie folgt vor.
**Anmerkung**
Wenn Sie mehr als ein Snowball Edge-Gerät zur Bereitstellung des Clusters verwenden, können Sie eine Amazon EKS Anywhere Anywhere-Admin-Instance auf jedem der Snowball Edge-Geräte starten.
**So führen Sie eine Amazon EKS Anywhere Anywhere-Admin-Instance aus**
1. Verwenden Sie den `create-key-pair` Befehl, um einen SSH-Schlüssel für die Amazon EKS Anywhere Anywhere-Admin-Instance zu erstellen. Der Befehl speichert den Schlüssel unter. `$PWD/key-file-name`
```
aws ec2 create-key-pair --key-name key-name --query 'KeyMaterial' --output text --endpoint http://snowball ip:8008 > key-file-name --profile profile-name
```
1. Verwenden Sie den `describe-images` Befehl, um den Bildnamen zu finden, `eks-anywhere-admin` der mit F beginnt.
```
aws ec2 describe-images --endpoint http://snowball-ip:8008 --profile profile-name
```
1. Verwenden Sie den `run-instance` Befehl, um eine eks-a admin-Instance mit dem Amazon EKS Anywhere Anywhere-Admin-Image zu starten.
```
aws ec2 run-instances --image-id eks-a-admin-image-id --key-name key-name --instance-type sbe-c.xlarge --endpoint http://snowball-ip:8008 --profile profile-name
```
1. Verwenden Sie den `describe-instances` Befehl, um den Status der Amazon EKS Anywhere Anywhere-Instance zu überprüfen. Warten Sie, bis der Befehl anzeigt, dass der Status der Instance ist, `running` bevor Sie fortfahren.
```
aws ec2 describe-instances --instance-id instance-id --endpoint http://snowball-ip:8008 --profile profile-name
```
1. Notieren Sie sich in der Ausgabe des `describe-device` Befehls den Wert von `PhysicalNetworkInterfaceId` für die physische Netzwerkschnittstelle, die mit Ihrem Netzwerk verbunden ist. Sie werden dies verwenden, um ein VNI zu erstellen.
```
PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge describe-device --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
```
1. Erstellen Sie ein VNI für die Amazon EKS Anywhere Anywhere-Admin-Instanz. Verwenden Sie den Wert von `PhysicalNetworkInterfaceId` als Wert des `physical-network-interface-id` Parameters.
```
PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --physical-network-interface-id PNI --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
```
1. Verwenden Sie den Wert von `IpAddress` als Wert des `public-ip` Parameters des `associate-address` Befehls, um die öffentliche Adresse der Amazon EKS Anywhere Anywhere-Admin-Instance zuzuordnen.
```
aws ec2 associate-address --instance-id instance-id --public-ip VNI-IP --endpoint http://snowball-ip:8008 --profile profile-name
```
1. Stellen Sie per SSH Connect zur Amazon EKS Anywhere Anywhere-Admin-Instanz her.
```
ssh -i path-to-key ec2-user@VNI-IP
```
#### Zertifikat- und Anmeldeinformationsdateien an die Admin-Instanz auf dem Snowball Edge übertragen
Nachdem die Amazon EKS Anywhere Anywhere-Admin-Instance ausgeführt wurde, übertragen Sie die Anmeldeinformationen und Zertifikate Ihrer Snowball Edge-Geräte auf die Admin-Instance. Führen Sie den folgenden Befehl in demselben Verzeichnis aus, in dem Sie die Anmelde- und Zertifikatsdateien gespeichert haben, in [Erstellen Sie einen Zugriffsschlüssel und eine Anmeldeinformationsdatei auf dem Snowball Edge](#create-eksa-iam-user-access-key) und[Erstellen Sie eine Zertifikatsdatei für die Admin-Instanz auf dem Snowball Edge](#create-credentials-for-admin-instance).
```
scp -i path-to-key path-to-credentials-file path-to-certificates-file ec2-user@eks-admin-instance-ip:~
```
Überprüfen Sie den Inhalt der Dateien auf der Amazon EKS Anywhere Anywhere-Admin-Instance. Im Folgenden finden Sie Beispiele für die Anmelde- und Zertifikatsdateien.
```
[192.168.1.1]
aws_access_key_id = EMGEZDGNBVGY3TQOJQGEZB5ULEAAIWHWUJDXEXAMPLE
aws_secret_access_key = AUHpqjO0GZQHEYXDbN0neLNlfR0gEXAMPLE
region = snow
[192.168.1.2]
aws_access_key_id = EMGEZDGNBVGY3TQOJQGEZG5O7F3FJUCMYRMI4KPIEXAMPLE
aws_secret_access_key = kY4Cl8+RJAwq/bu28Y8fUJepwqhDEXAMPLE
region = snow
```
```
-----BEGIN CERTIFICATE-----
ZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGUgZWtzYSBzbm93IHRlc3QgY2VydGlm
aWNhdGVla3NhIHNub3cgdGVzdCBjZXJ0aWZpY2F0ZWVrc2Egc25vdyB0ZXN0IGNl
cnRpZmljYXRlZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGVla3NhIHNub3cgdGVz
dCBjZXJ0aWZpY2F0ZQMIIDXDCCAkSgAwIBAgIJAISM0nTVmbj+MA0GCSqGSIb3DQ
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
KJ0FPl2PAYPEjxr81/PoCXfZeARBzN9WLUH5yz1ta+sYUJouzhzWuLJYA1xqcCPY
mhVlkRsN4hVdlBNRnCCpRF766yjdJeibKVzXQxoXoZBjrOkuGwqRy3d3ndjK77h4
OR5Fv9mjGf7CjcaSjk/4iwmZvRSaQacb0YG5GVeb4mfUAuVtuFoMeYfnAgMBAAGj
azBpMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFL/bRcnBRuSM5+FcYFa8HfIBomdF
...
-----END CERTIFICATE-----
```