RDSMySQLDBSecurityGroup:
Type: AWS::EC2::SecurityGroup
Properties:
GroupDescription: RDS SG group
Tags:
- Key: Name
Value: Workshop-RDS-SG
VpcId: !ImportValue VPC
SecurityGroupEgress:
- IpProtocol: tcp
FromPort: 3306
ToPort: 3306
CidrIp: 0.0.0.0/0
SecurityGroupIngress:
- CidrIp: 172.100.0.0/16
Description: Allow DB Access from Container Instances
IpProtocol: tcp
FromPort: 3306
ToPort: 3306
{{% /expand%}}
___
### Anwendung
Im Folgenden wirst du eine CloudFormation Vorlage ausführen. Da manche Teile der Infrastruktur noch zum Beispiel Code benötigen wie die Lambda-Funktion oder das Frontend, werden wir diese separat anlegen. Um das noch mehr zu automatisieren, kannst du mit einer CDK arbeiten, was aber auf dieser Plattform limitiert ist.
1. Unter Services den Dienst **S3** auswählen.
1. Klicke auf **Create bucket**, um einen neuen Bucket zu erstellen.
1. Gebe deinem Bucket einen weltweit einzigartigen Namen, der mit ``cloudformation`` beginnen soll, zum Beispiel ``cloudformation-{yourname}``
1. Klicke auf **Create bucket**.
1. Kopiere den Namen des Buckets. Diesen wirst du im nächsten Schritt benötigen.
1. Öffne deinen Bucket und erstelle einen Ordner mit dem Namen ``Vorlage``.
1. Öffne in einem neuen Tab den Dienst **Cloud9** und öffne dort wieder deine Umgebung **Uek Umgebung**.
1. Gehe in den Ordner **cloudformation/assets** durch ``cd ~/environment/cloud-app-builders-modules-german/src/cloudformation/assets``.
1. Kopiere nun alle Dateien aus diesem Ordner in deinen Bucket. Ersetze DEIN_BUCKET durch den Namen deines erstellten Buckets. Sync wird genutzt, damit alle Dateien auf diesem Ordner kopiert werden.
```
aws s3 sync . s3://DEIN_BUCKET
```
#### Bereitstellung der Vorlage
1. Bleibe in **Cloud9** und gehe in den Ordner **src/cloudformation**.
2. Kopiere nun **cloudFormationToDo.yml** in deinen Bucket, der mit ``cloudformation`` beginnt, in den Ordner **Vorlage**. Ersetze wieder DEIN_BUCKET durch den Namen deines erstellten Buckets.
```
aws s3 cp cloudFormationToDo.yml s3://DEIN_BUCKET/Vorlage/
```
#### Ausführung der Vorlage
1. Wähle unter Services den Dienst **S3** und gehe zu deinem Bucket in den Ordner **Vorlage**.
1. Dort sollte nun die kopierte Vorlage sein. Wähle diese aus und klick auf **Copy URL**.
1. Unter Services den Dienst **CloudFormation** auswählen.
1. Klicke auf **Create stack** und wähle **with new resources (standard)** aus.
1. Lege deine Vorlage fest, indem du **Amazon S3 URL** auswählst. Gib nun die kopierte URL ein und klicke auf **Next**.
1. Benenne den Stack `ToDoStack`.
1. Fülle die Parameter wie folgt aus (siehe das nächste Bild):
1. Für **URIbackend** füge die URI von deinem Container Image in Amazon ECR aus dem **[Amazon ECS](https://docs.aws.amazon.com/de_de/AmazonECS/latest/developerguide/Welcome.html)** integriert werden, der bisher [Container Image Kapitel]({{< ref "/modul_210/container" >}} "Container Image Kapitel") ein. Unter Services den Dienst **Elastic Container Registry** in einem neuen Browser Fenster öffnen. In der Liste der Private Repositories auf das repository mit dem Namen `workshop-backend` klicken. In der Liste der Images auf **Copy URI** klicken, um die URI vom backend container image zu kopieren und dann in dem anderen Browser Fenster mit den CloudFormation Parametern einfügen.
2. Tippe in das Textfeld vom Parameter **pwDatabase** ein Passwort für die Datenbank, zum Beispiel ``todopassword``.
3. Füge den Namen des Amazon S3-Buckets ein, den du zuvor erstellt hast, um die benötigten Dateien für CloudFormation bereitzustellen für **s3AssetBucketName**.
4. In **userDatabase** gebe ``clusteradmin`` ein. Klicke auf **Next**.
1. Wähle unter **Permissions** die **LabRole** als Rolle aus und klicke **Next**.
1. Danach klicke auf **Submit**, um deinen Stack auszuführen und deine Architektur automatisch erstellen zu lassen.
1. Klicke auf das Tab **Resources**, um zu sehen, welche Ressourcen für die Anwendung erstellt werden. Schaue dir die einzelnen Komponenten an und überlege, ob du diese bereits aus vorherigen Kapiteln kennst.
{{% notice note %}}
Es kann bis zu 30 Minuten dauern, bis die **CloudFormation Vorlage** ausgeführt ist. Währenddessen werden immer Services verfügbar sein, die bereits erstellt wurden, sodass du dir diese unter **Resources** in deinem Stack anschauen kannst.
{{% /notice %}}
#### Finale Schritte
Es fehlt noch das Frontend:
1. Die Vorlage hat einen neuen Bucket erstellt. Du kannst den Bucket in **S3** finden und sein Name beginnt mit `todostack`.
1. Öffne in einem neuen Tab den Dienst **Cloud9** und öffne dort wieder deine Umgebung **Uek Umgebung**.
1. Gehe in den Ordner **todo-frontend** durch ``cd cloud-app-builders-modules-german/src/todo-frontend/build``.
1. Kopiere nun alle Dateien aus diesem Ordner in deinen Bucket. Ersetze DEIN_BUCKET durch den Namen des erstellten Buckets beginnend mit `todostack`. Sync wird genutzt, damit alle Dateien auf diesem Ordner kopiert werden.
```
aws s3 sync . s3://DEIN_BUCKET
```
#### Test der ToDo-Liste
Die Vorlage hat die gleiche ToDo-App auf Containern nochmal nachgebaut, sodass du diese auch nochmal testen kannst.
1. Unter Services den Dienst **CloudFront** auswählen.
2. Der **Stack** hat auch einen Zugriff auf die ContainerAPIs von Front- und Backend aus den ersten Kapiteln erstellt. Klicke auf die neue CloudFront distribution. Kopiere den Domain Namen, der ca. so aussehen sollte: `d1xz0u2lqfxspu.cloudfront.net`.
3. Öffne den Link in einem neuen Browsertab und nun siehst du wieder deine ToDo-Liste als Anwendung. Sie ist noch leer, da die Infrastruktur gerade erst erstellt wurde.
4. Teste die Funktionalitäten der Anwendung, wie es bereits aus vorherigen Kapiteln kennst.
Wenn du die serverlose Infrastruktur auch nutzen willst, kannst du diese wieder umstellen:
1. Rufe deine ToDo-Webseite auf.
1. Nutze den Rechtsklick, um die Webseite zu **[inspizieren](https://digitalfahrschule.de/element-untersuchen-im-chrome/)**.
1. Klicke auf die **Console** und führe dort ``sessionStorage.setItem("apiBase", "/api/v2/")``. Dadurch wird nun die serverlosen Services genutzt.
1. Um wieder die Container zu nutzen, führe ``sessionStorage.setItem("apiBase", "/api/v1/")`` in der Console aus. Nun sind deine Aufgaben wieder zusehen.
#### Clean up
Nun hast du die Vorlage der Infrastruktur für deine ToDo-App erfolgreich ausgeführt. Da nicht alle Ressourcen und Anwendungen in der Cloud dauerhaft gebraucht werden, lässt sich auch diese Infrastruktur leicht deprovisionieren.
1. Unter Services den Dienst **CloudFormation** auswählen.
2. Wähle deinen `ToDoStack` Stack aus.
3. Klicke oben rechts auf **Delete**.
4. Bestätige, dass du den Stack löschen möchtest.
Nun wird deine ToDo-App wieder gelöscht.
Lösche zudem den S3 Bucket, in dem die CloudFormation Vorlage gespeichert ist.
1. Unter Services den Dienst **S3** auswählen.
2. In der Buckets Liste nach dem Namen `cloudformation-{yourname}` von deinem S3 Bucket suchen.
3. Wähle deinen S3 Bucket in der Liste aus und klicke auf **Empty**.
4. Gebe `permanently delete` in das Textfeld ein und klicke **Empty**. Dadurch werden all Objekte in dem Bucket gelöscht.
5. Wähle deinen S3 Bucket in der Liste erneut aus und klicke auf **Delete**.
6. Gebe den Namen von deinem S3 Bucket in das Textfeld und klicke auf **Delete bucket**. Nun wurde der S3 Bucket gelöscht.
### Zusammenfassung und nächste Schritte
Herzlichen Glückwunsch! Du hast erfolgreich deine ToDo-App als Infrastuktur-as-Code aufgesetzt und ausgeführt. Durch diese Art ganze Anwendungen auszuführen, kannst du sie leicht verändern, mit anderen teilen und mehrfach ausführen.
Du hast insgesamt mehrere Möglichkeiten gesehen, wie du deine Anwendung in der Cloud umsetzen kannst. Im Folgenden werden diese nochmal zusammengefasst.