

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.

# Installationsoptionen
<a name="installation-options"></a>

Es gibt zwei Hauptmethoden zur Installation von Red Hat OpenShift auf: AWS
+ Vom Installateur bereitgestellte Infrastruktur (IPI) – Der Benutzer stellt die grundlegenden Informationen bereit (z. B. die Anzahl der Computer auf der Steuerebene) und kann für die meisten Fragen Standardwerte wählen. Das Red Hat OpenShift Service on AWS Command Line Utility (`rosa`CLI) kann in einer IPI-Struktur platziert werden, wie im nächsten Abschnitt beschrieben.
+ Vom Benutzer bereitgestellte Infrastruktur (UPI) — Alle Infrastrukturkomponenten wie Domain Name Server (DNS), Amazon Virtual Private Clouds (VPCs), Bootstrap-Maschinen und Steuerungsebenen werden manuell erstellt, und Red Hat OpenShift wird auf dieser Infrastruktur installiert.

Beide Setups verwenden dasselbe Installationsprogramm (`install-config.yaml`), wodurch Komponenten auf der Grundlage von Zielen und Abhängigkeiten installiert werden. Jedes Ziel hat seine eigenen Abhängigkeiten, sodass das Programm mehrere Ziele parallel unterstützen und sicherstellen kann, dass das Ziel den Cluster erfolgreich ausführen kann. Das folgende Diagramm zeigt einige der Ziele und Abhängigkeiten.

![Ziele und Abhängigkeiten für Red Hat auf OpenShift AWS](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/red-hat-openshift-on-aws-implementation/images/targets-dependencies.png)


## Vor- und Nachteile der einzelnen Methoden
<a name="adv-disadv"></a>


****  

| Vom Installateur bereitgestellte Infrastruktur (IPI) | Vom Benutzer bereitgestellte Infrastruktur (UPI) | 
| --- | --- | 
| Einfach zu installieren. | Komplex; die Einrichtung dauert einige Zeit. | 
| Bietet nicht viele Anpassungsoptionen. | Sie können die Topologie und die gesamte Infrastruktur anpassen. | 
| Unterstützungen AWS und andere Public-Cloud-Optionen. | Unterstützt VMware Bare-Metal-Systeme AWS sowie andere Cloud-Optionen. | 
| Erstellt alle Infrastrukturkomponenten, einschließlich Load Balancer und virtuellen Netzwerken. | Kann verwendet werden, wenn die zugrunde liegende Plattform nicht alle Anforderungen erfüllt. (Bare-Metal-Systeme bieten z. B. keine Load Balancer.) | 
| Hochgradig automatisiert. | Erfordert, dass Sie die gesamte Automatisierungsebene für die Bereitstellung der zugrunde liegenden Infrastruktur erstellen. Zu diesem Zweck können Sie AWS CloudFormation Vorlagen verwenden. | 
| Prüfungen der Voraussetzungen sind einfach durchzuführen. | Die Voraussetzungen müssen sorgfältig geprüft werden. | 

## IPI-Beispiel – Verwendung der `rosa`-CLI
<a name="ipi-example1"></a>

Red Hat OpenShift Service on AWS implementiert eine IPI-Installation, bietet jedoch zusätzliche Vorteile. Sie verwenden die `rosa` CLI, um einen Red Hat OpenShift auf AWS Clustern und Ressourcen zu verwalten (zu aktualisieren, zu löschen oder bereitzustellen). Weitere Informationen finden Sie in der [Red OpenShift Hat-Dokumentation](https://docs.openshift.com/rosa/rosa_getting_started/rosa-getting-started.html). 

Um einen Red OpenShift Hat-Cluster bereitzustellen AWS, installieren Sie zunächst die `rosa` CLI und stellen sicher, dass das AWS Command Line Interface (AWS CLI) auf Ihr AWS Konto verweist. Dann können Sie die `rosa`-CLI zur Durchführung von Validierungen und zur Bereitstellung des Clusters mithilfe von Befehlen verwenden, die den folgenden ähneln.

```
rosa verify permissions [arguments]
rosa download oc

rosa verify quota [arguments]
rosa init --token=<token> 
rosa create cluster --cluster-name=<cluster_name>
```

Wenn der Cluster bereitgestellt wurde, können Sie ihn mithilfe von OpenShift Befehlen überprüfen.

```
oc get nodes (list all nodes if connected to cluster)
oc get ns (list all namespaces)
```

Weitere Informationen finden Sie in der [OpenShift -Dokumentation](https://docs.openshift.com/rosa/cli_reference/openshift_cli/getting-started-cli.html). 

Die Vorteile dieser Methode sind folgende:
+ Der Cluster ist einfach einzurichten und schnell bereitzustellen in AWS.
+ Stellt Protokollierungsinformationen bereit; einfache Problembehebung, falls etwas schief geht.
+ Kann die Voraussetzungen über die Befehlszeile anzeigen.
+ Kann auch für Löschungen und andere Operationen verwendet werden.

Einige mögliche Bedenken:
+ Die Anpassungsoptionen sind möglicherweise begrenzt.
+ Erfordert die `rosa` CLI und andere grundlegende Einstellungen. AWS CLI
+ Alle Herausforderungen im Zusammenhang mit IPI beziehen sich auch auf die Verwendung der `rosa`-CLI.

## IPI-Beispiel – Verwendung von `openshift-install`
<a name="ipi-example2"></a>

`openshift-install` ist ein Befehlszeilenprogramm, mit dem Sie schnell einen Cluster erstellen können. Dieser Befehl bietet eine gewisse Flexibilität durch Änderungen an der `install-config.yaml`-Datei. In diesem Abschnitt werden die wichtigsten Schritte zur Verwendung des Hilfsprogramms beschrieben. Detaillierte Installationsschritte finden Sie in der [OpenShift Dokumentation](https://docs.openshift.com/container-platform/4.6/installing/installing_aws/installing-aws-default.html).

1. Holen Sie das Installationsprogramm von der [RedHat-Webseite](https://console.redhat.com/openshift/install) (erfordert ein Red-Hat-Konto).

1. Entpacken Sie das Paket. 

   ```
   tar xvf openshift-install-linux.tar.gz
   ```

1. Identifizieren Sie das Installationsverzeichnis und führen Sie den `create cluster`-Befehl aus.

   ```
   ./openshift-install create cluster --dir <installation_directory> --log-level=info
   ```

1. Um die Installation anzupassen, generieren Sie die `install-config.yaml`-Datei.

   ```
   ./openshift-install create install-config --dir <installation_directory>
   ```

Nachfolgend finden Sie einen Auszug aus einer Beispiel-`install-config.yaml`-Datei. Die Konfigurationsoptionen finden Sie in der [OpenShift Dokumentation](https://docs.openshift.com/container-platform/4.7/installing/installing_aws/installing-aws-customizations.html).

```
      apiVersion: v1
baseDomain: sample.com 
credentialsMode: Mint 
controlPlane:   
  hyperthreading: Enabled 
  name: master
  platform:
    aws:
      zones:
      - us-east-2a
      - us-east-2b
      rootVolume:
        iops: 4000
        size: 500
        type: io1 
      type: m5.xlarge
  replicas: 3
compute: 
- hyperthreading: Enabled 
  name: worker
  platform:
    aws:
      rootVolume:
        iops: 2000
        size: 500
        type: io1 
      type: c5.4xlarge
      zones:
      - us-east-2c
  replicas: 3
metadata:
  name: sample-cluster 
networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16
  networkType: OpenShiftSDN
  serviceNetwork:
  - 172.30.0.0/16
platform:
  aws:
    region: us-west-2 
    userTags:
      adminContact: jdoe
      costCenter: 7536
    amiID: ami-96c6f8f7 
    serviceEndpoints: 
      - name: ec2
        url: https://vpce-id.ec2.us-west-2.vpce.amazonaws.com
fips: false 
sshKey: ssh-ed25519 AAAA... 
pullSecret: '{"auths": ...}'
```

## UPI-Beispiel — Installation auf einer vom Benutzer bereitgestellten Infrastruktur AWS
<a name="upi-example"></a>

Sie können einen Red Hat OpenShift Cluster auf einer bestehenden AWS Infrastruktur bereitstellen, die Sie separat bereitstellen. Um die Infrastruktur bereitzustellen, können Sie CloudFormation Vorlagen verwenden, um die VPC, die gehostete Zone, DNS-Einträge und andere Komponenten zu erstellen. Detaillierte Schritte und CloudFormation Vorlagen finden Sie in der [OpenShift Dokumentation](https://docs.redhat.com/en/documentation/openshift_container_platform/4.1/html/installing/installing-on-user-provisioned-aws).

Wenn der Cluster bereitgestellt wurde, müssen Sie alle Zertifikatsignieranfragen (CSRs) genehmigen, um die Worker-Knoten in einen `Ready` Status zu versetzen.

```
oc get nodes

NAME      STATUS    ROLES   AGE  VERSION
master-0  Ready     master  63m  v1.13.4+b626c2fe1
master-1  Ready     master  63m  v1.13.4+b626c2fe1
master-2  Ready     master  64m  v1.13.4+b626c2fe1
worker-0  NotReady  worker  76s  v1.13.4+b626c2fe1
worker-1  NotReady  worker  70s  v1.13.4+b626c2fe1
```

Mit dem folgenden Befehl können Sie alle Zertifikate in einem Schritt genehmigen.

```
    oc get csr -ojson | jq -r '.items[] | select(.status == {} ) | .metadata.name' | xargs oc adm certificate approve
```

Sie können über die `oc`-Befehlszeile oder über die Red-Hat-Konsole überprüfen, ob alle Operatoren in der `Ready`-Phase sind.

Nach der Überprüfung können Sie die Bootstrap-Ressourcen löschen. Das können Sie `stack-name` anhand des und anhand des Namens ermitteln AWS-Managementkonsole, den Sie bei der Erstellung des Stacks angegeben haben.

```
aws cloudformation delete-stack --stack-name <name> 
```

Beenden Sie die Bereitstellung des Clusters mit dem folgenden Befehl.

```
./openshift-install --dir=<installation_directory> wait-for install-complete 

INFO Waiting up to 30m0s for the cluster to initialize...
```

Stellen Sie sicher, dass Sie die Protokolle überprüfen und sicherstellen, dass keine Fehler vorliegen, bevor Sie den Cluster an Ihre Stakeholder weitergeben.