Hinweis zum Ende des Supports: Am 31. Mai 2026 AWS endet der Support für AWS Panorama. Nach dem 31. Mai 2026 können Sie nicht mehr auf die AWS Panorama Konsole oder AWS Panorama die Ressourcen zugreifen. Weitere Informationen finden Sie unter [AWS Panorama Ende des Supports](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html).
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.
# Bereitstellung der AWS Panorama Panorama-Beispielanwendung
Nachdem Sie [Ihre AWS Panorama Appliance oder ein kompatibles Gerät eingerichtet](gettingstarted-setup.md) und dessen Software aktualisiert haben, stellen Sie eine Beispielanwendung bereit. In den folgenden Abschnitten importieren Sie eine Beispielanwendung mit der AWS Panorama Application CLI und stellen sie mit der AWS Panorama Panorama-Konsole bereit.
Die Beispielanwendung verwendet ein Modell für maschinelles Lernen, um Objekte in Videobildern einer Netzwerk-Kamera zu klassifizieren. Es verwendet das AWS Panorama Application SDK, um ein Modell zu laden, Bilder abzurufen und das Modell auszuführen. Die Anwendung überlagert dann das Originalvideo mit den Ergebnissen und gibt es auf einem angeschlossenen Display aus.
In einer Einzelhandelsumgebung können Sie durch die Analyse von Fußgängerverkehrsmustern das Verkehrsaufkommen vorhersagen. Durch die Kombination der Analyse mit anderen Daten können Sie den erhöhten Personalbedarf an Feiertagen und anderen Veranstaltungen einplanen, die Effektivität von Werbung und Verkaufsförderung messen oder die Platzierung von Displays und die Inventarverwaltung optimieren.
**Topics**
+ [Voraussetzungen](#gettingstarted-deploy-prerequisites)
+ [Importieren Sie die Beispielanwendung](#gettingstarted-deploy-import)
+ [Bereitstellen der Anwendung](#gettingstarted-deploy-deploy)
+ [Sehen Sie sich die Ausgabe an](#gettingstarted-deploy-view)
+ [Aktivieren Sie das SDK für Python](#gettingstarted-deploy-redeploy)
+ [Bereinigen](#gettingstarted-deploy-cleanup)
+ [Nächste Schritte](#gettingstarted-deploy-next)
## Voraussetzungen
Für die Verfahren in diesem Tutorial benötigen Sie ein Befehlszeilen-Terminal oder eine Befehlszeilen-Shell zum Ausführen der Befehle. In den Codelisten werden den Befehlen ein Eingabeaufforderungssymbol (\$1) und gegebenenfalls der Name des aktuellen Verzeichnisses vorangestellt.
```
~/panorama-project$ this is a command
this is output
```
Bei langen Befehlen verwenden wir ein Escape-Zeichen (`\`), um einen Befehl auf mehrere Zeilen aufzuteilen.
Verwenden Sie auf Linux und macOS Ihren bevorzugten Shell- und Paket-Manager. Sie können unter Windows 10 das [Windows-Subsystem für Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10) installieren, um eine Windows-Version von Ubuntu und Bash zu erhalten. Hilfe beim Einrichten einer Entwicklungsumgebung in Windows finden Sie unter[Eine Entwicklungsumgebung in Windows einrichten](applications-devenvwindows.md).
Sie verwenden Python, um AWS-Panorama-Anwendungen zu entwickeln und Tools mit Pip, dem Paketmanager von Python, zu installieren. Wenn Sie Python noch nicht haben, [installieren Sie die neueste Version](https://www.python.org/downloads/). Wenn Sie Python 3 haben, aber nicht Pip, installieren Sie Pip mit dem Paketmanager Ihres Betriebssystems oder installieren Sie eine neue Version von Python, die mit Pip geliefert wird.
In diesem Tutorial verwenden Sie Docker, um den Container zu erstellen, auf dem Ihr Anwendungscode ausgeführt wird. [Installieren Sie Docker von der Docker-Website: Holen Sie sich Docker](https://docs.docker.com/get-docker/)
In diesem Tutorial wird die AWS Panorama Application CLI verwendet, um die Beispielanwendung zu importieren, Pakete zu erstellen und Artefakte hochzuladen. Die AWS Panorama Application CLI verwendet die AWS Command Line Interface (AWS CLI), um Service-API-Operationen aufzurufen. Wenn Sie die bereits haben AWS CLI, aktualisieren Sie sie auf die neueste Version. Um die AWS Panorama Application CLI zu installieren und AWS CLI, verwenden Sie`pip`.
```
$ pip3 install --upgrade awscli panoramacli
```
Laden Sie die Beispielanwendung herunter und extrahieren Sie sie in Ihren Workspace.
****
+ **Beispielanwendung** — [aws-panorama-sample.zip](https://github.com/awsdocs/aws-panorama-developer-guide/releases/download/v1.0-ga/aws-panorama-sample.zip)
## Importieren Sie die Beispielanwendung
Verwenden Sie die AWS Panorama Application CLI, um die Beispielanwendung zur Verwendung in Ihrem Konto zu importieren. Die Ordner und das Manifest der Anwendung enthalten Verweise auf eine Platzhalter-Kontonummer. Führen Sie den `panorama-cli import-application` Befehl aus, um diese mit Ihrer Kontonummer zu aktualisieren.
```
aws-panorama-sample$ panorama-cli import-application
```
Das `SAMPLE_CODE` Paket im `packages` Verzeichnis enthält den Code und die Konfiguration der Anwendung, einschließlich einer Docker-Datei, die das Basisimage der Anwendung verwendet. `panorama-application` Verwenden Sie den Befehl, um den Anwendungscontainer zu erstellen, der auf der Appliance ausgeführt wird`panorama-cli build-container`.
```
aws-panorama-sample$ ACCOUNT_ID=$(aws sts get-caller-identity --output text --query 'Account')
aws-panorama-sample$ panorama-cli build-container --container-asset-name code_asset --package-path packages/${ACCOUNT_ID}-SAMPLE_CODE-1.0
```
Der letzte Schritt mit der AWS Panorama Application CLI besteht darin, den Code und die Modellknoten der Anwendung zu registrieren und Ressourcen auf einen vom Service bereitgestellten Amazon S3 S3-Zugriffspunkt hochzuladen. Zu den Ressourcen gehören das Container-Image des Codes, das Modell und jeweils eine Deskriptordatei. Führen Sie den `panorama-cli package-application` Befehl aus, um die Knoten zu registrieren und Ressourcen hochzuladen.
```
aws-panorama-sample$ panorama-cli package-application
Uploading package model
Registered model with patch version bc9c58bd6f83743f26aa347dc86bfc3dd2451b18f964a6de2cc4570cb6f891f9
Uploading package code
Registered code with patch version 11fd7001cb31ea63df6aaed297d600a5ecf641a987044a0c273c78ceb3d5d806
```
## Bereitstellen der Anwendung
Verwenden Sie die AWS-Panorama-Konsole, um die Anwendung auf Ihrer Appliance bereitzustellen.
**So stellen Sie die Anwendung bereit**
1. Öffnen Sie die [Seite Bereitgestellte Anwendungen](https://console.aws.amazon.com/panorama/home#deployed-applications) der AWS-Panorama-Konsole.
1. Wählen Sie **Anwendung bereitstellen** aus.
1. Fügen Sie den Inhalt des Anwendungsmanifests,`graphs/aws-panorama-sample/graph.json`, in den Texteditor ein. Wählen Sie **Weiter**.
1. Geben Sie als **Anwendungsname** ein `aws-panorama-sample`.
1. Wählen Sie **Weiter zur Bereitstellung** aus.
1. Wählen Sie Mit **der Bereitstellung beginnen** aus.
1. Wählen Sie **Weiter**, ohne eine Rolle auszuwählen.
1. **Wählen Sie Gerät auswählen** und wählen Sie dann Ihr Gerät aus. Wählen Sie **Weiter**.
1. **Wählen Sie im Schritt Datenquellen** auswählen die Option **Eingabe (en) anzeigen** aus und fügen Sie Ihren Kamerastream als Datenquelle hinzu. Wählen Sie **Weiter**.
1. Wählen **Sie im Schritt Konfigurieren** die Option **Weiter** aus.
1. Wählen Sie **Bereitstellen** und dann **Fertig** aus.
1. Wählen Sie in der Liste der bereitgestellten Anwendungen die Option **aws-panorama-sample**.
Aktualisieren Sie diese Seite für Updates, oder verwenden Sie das folgende Skript, um die Bereitstellung von der Befehlszeile aus zu überwachen.
**Example monitor-deployment.sh**
```
while true; do
aws panorama list-application-instances --query 'ApplicationInstances[?Name==`aws-panorama-sample`]'
sleep 10
done
```
```
[
{
"Name": "aws-panorama-sample",
"ApplicationInstanceId": "applicationInstance-x264exmpl33gq5pchc2ekoi6uu",
"DefaultRuntimeContextDeviceName": "my-appliance",
"Status": "DEPLOYMENT_PENDING",
"HealthStatus": "NOT_AVAILABLE",
"StatusDescription": "Deployment Workflow has been scheduled.",
"CreatedTime": 1630010747.443,
"Arn": "arn:aws:panorama:us-west-2:123456789012:applicationInstance/applicationInstance-x264exmpl33gq5pchc2ekoi6uu",
"Tags": {}
}
]
[
{
"Name": "aws-panorama-sample",
"ApplicationInstanceId": "applicationInstance-x264exmpl33gq5pchc2ekoi6uu",
"DefaultRuntimeContextDeviceName": "my-appliance",
"Status": "DEPLOYMENT_PENDING",
"HealthStatus": "NOT_AVAILABLE",
"StatusDescription": "Deployment Workflow has completed data validation.",
"CreatedTime": 1630010747.443,
"Arn": "arn:aws:panorama:us-west-2:123456789012:applicationInstance/applicationInstance-x264exmpl33gq5pchc2ekoi6uu",
"Tags": {}
}
]
...
```
Wenn die Anwendung nicht gestartet wird, überprüfen Sie die [Anwendungs- und Geräteprotokolle](monitoring-logging.md) in Amazon CloudWatch Logs.
## Sehen Sie sich die Ausgabe an
Wenn die Bereitstellung abgeschlossen ist, beginnt die Anwendung mit der Verarbeitung des Videostreams und sendet Protokolle an CloudWatch.
**Um Protokolle in CloudWatch Logs anzuzeigen**
1. Öffnen Sie die [Seite Protokollgruppen der CloudWatch Logs-Konsole](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups).
1. Sie finden die AWS Panorama Panorama-Anwendungs- und Appliance-Protokolle in den folgenden Gruppen:
****
+ **Geräteprotokolle** — `/aws/panorama/devices/device-id`
+ **Anwendungsprotokolle** — `/aws/panorama/devices/device-id/applications/instance-id`
```
2022-08-26 17:43:39 INFO INITIALIZING APPLICATION
2022-08-26 17:43:39 INFO ## ENVIRONMENT VARIABLES
{'PATH': '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin', 'TERM': 'xterm', 'container': 'podman'...}
2022-08-26 17:43:39 INFO Configuring parameters.
2022-08-26 17:43:39 INFO Configuring AWS SDK for Python.
2022-08-26 17:43:39 INFO Initialization complete.
2022-08-26 17:43:39 INFO PROCESSING STREAMS
2022-08-26 17:46:19 INFO epoch length: 160.183 s (0.936 FPS)
2022-08-26 17:46:19 INFO avg inference time: 805.597 ms
2022-08-26 17:46:19 INFO max inference time: 120023.984 ms
2022-08-26 17:46:19 INFO avg frame processing time: 1065.129 ms
2022-08-26 17:46:19 INFO max frame processing time: 149813.972 ms
2022-08-26 17:46:29 INFO epoch length: 10.562 s (14.202 FPS)
2022-08-26 17:46:29 INFO avg inference time: 7.185 ms
2022-08-26 17:46:29 INFO max inference time: 15.693 ms
2022-08-26 17:46:29 INFO avg frame processing time: 66.561 ms
2022-08-26 17:46:29 INFO max frame processing time: 123.774 ms
```
Um die Videoausgabe der Anwendung anzuzeigen, schließen Sie das Gerät über ein HDMI-Kabel an einen Monitor an. Standardmäßig zeigt die Anwendung jedes Klassifizierungsergebnis an, für das eine Zuverlässigkeit von mehr als 20% besteht.
**Example [squeezenet\$1classes.json](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/squeezenet_classes.json)**
```
["tench", "goldfish", "great white shark", "tiger shark",
"hammerhead", "electric ray", "stingray", "cock", "hen", "ostrich",
"brambling", "goldfinch", "house finch", "junco", "indigo bunting",
"robin", "bulbul", "jay", "magpie", "chickadee", "water ouzel",
"kite", "bald eagle", "vulture", "great grey owl",
"European fire salamander", "common newt", "eft",
"spotted salamander", "axolotl", "bullfrog", "tree frog",
...
```
Das Beispielmodell umfasst 1000 Klassen, darunter viele Tiere, Lebensmittel und gewöhnliche Objekte. Versuchen Sie, Ihre Kamera auf eine Tastatur oder eine Kaffeetasse zu richten.
![\[\]](http://docs.aws.amazon.com/de_de/panorama/latest/dev/images/mug.jpg)
Der Einfachheit halber verwendet die Beispielanwendung ein einfaches Klassifizierungsmodell. Das Modell gibt ein einzelnes Array mit einer Wahrscheinlichkeit für jede seiner Klassen aus. In realen Anwendungen werden häufiger Objekterkennungsmodelle mit mehrdimensionaler Ausgabe verwendet. Beispielanwendungen mit komplexeren Modellen finden Sie unter. [Beispielanwendungen, Skripte und Vorlagen](panorama-samples.md)
## Aktivieren Sie das SDK für Python
Die Beispielanwendung verwendet die AWS SDK für Python (Boto) , um Metriken an Amazon zu senden CloudWatch. Um diese Funktion zu aktivieren, erstellen Sie eine Rolle, die der Anwendung die Erlaubnis erteilt, Metriken zu senden, und stellen Sie die Anwendung mit der angehängten Rolle erneut bereit.
Die Beispielanwendung enthält eine CloudFormation Vorlage, mit der eine Rolle mit den erforderlichen Berechtigungen erstellt wird. Verwenden Sie den `aws cloudformation deploy` Befehl, um die Rolle zu erstellen.
```
$ aws cloudformation deploy --template-file aws-panorama-sample.yml --stack-name aws-panorama-sample-runtime --capabilities CAPABILITY_NAMED_IAM
```
**Um die Anwendung erneut bereitzustellen**
1. Öffnen Sie die [Seite Bereitgestellte Anwendungen](https://console.aws.amazon.com/panorama/home#deployed-applications) der AWS-Panorama-Konsole.
1. Wählen Sie eine Anwendung aus.
1. Wählen Sie **Replace (Ersetzen)** aus.
1. Führen Sie die Schritte zur Bereitstellung der Anwendung aus. Wählen **Sie im Feld IAM-Rolle angeben** die Rolle aus, die Sie erstellt haben. Ihr Name beginnt mit `aws-panorama-sample-runtime`.
1. Wenn die Bereitstellung abgeschlossen ist, öffnen Sie die [CloudWatchKonsole](https://console.aws.amazon.com/cloudwatch/home#metricsV2:graph=~();namespace=~'AWSPanoramaApplication) und sehen Sie sich die Metriken im `AWSPanoramaApplication` Namespace an. Alle 150 Frames protokolliert die Anwendung Metriken für die Frame-Verarbeitung und die Inferenzzeit und lädt sie hoch.
## Bereinigen
Wenn Sie mit der Arbeit an der Beispielanwendung fertig sind, können Sie sie mit der AWS-Panorama-Konsole aus der Appliance entfernen.
**Um die Anwendung von der Appliance zu entfernen**
1. Öffnen Sie die [Seite Bereitgestellte Anwendungen](https://console.aws.amazon.com/panorama/home#deployed-applications) der AWS-Panorama-Konsole.
1. Wählen Sie eine Anwendung aus.
1. Wählen Sie **Vom Gerät löschen**.
## Nächste Schritte
Falls bei der Bereitstellung oder Ausführung der Beispielanwendung Fehler aufgetreten sind, finden Sie weitere Informationen unter[Fehlerbehebung](panorama-troubleshooting.md).
Wenn Sie mehr über die Funktionen und die Implementierung der Beispielanwendung erfahren möchten, fahren Sie mit [dem nächsten Thema](gettingstarted-sample.md) fort.