Mit der arcgis-ami-linux.template.json Amazon Web Services (AWS) CloudFormation-Vorlage wird ein Amazon Machine Image (AMI) mit einem Linux-Betriebssystem und ArcGIS Enterprise-Komponenten Ihrer Wahl erstellt.
Eine Liste mit unterstützten Linux-Betriebssystemen finden Sie unter Bei Verwendung von CloudFormation zur Bereitstellung von ArcGIS auf AWS unterstützte Betriebssysteme.
Voraussetzungen
Die Voraussetzungen können nach den Elementen (zum Beispiel Dateien und Konten), die Sie abrufen müssen, und den Tasks, die Sie ausführen müssen, bevor die CloudFormation-Vorlage ausgeführt wird, gruppiert werden.
Erforderliche Elemente
Zum Ausführen dieser Vorlage benötigen Sie Folgendes:
- Ein Amazon Web Services-Konto.
Das Konto muss Zugriff auf AWS-Basisservices haben, wie etwa auf CloudFormation, Amazon Elastic Compute Cloud (EC2), Amazon Virtual Private Cloud (VPC), Systems Manager, Amazon CloudWatch, AWS Identity and Access Management (IAM) und Secrets Manager.
- Eine Amazon Virtual Private Cloud (VPC) und Subnetze.
Sie können eine der folgenden CloudFormation-Vorlagen verwenden, um eine VPC zu erstellen: VPC mit zwei öffentlichen Subnetzen oder VPC mit zwei öffentlichen und privaten Subnetzen mit einem NAT-Gateway.
Die AMI-ID des Linux-Betriebssystems Ihrer Wahl (weitere Informationen hierzu finden Sie in der Liste der unterstützten Linux-Betriebssysteme weiter oben). Sie erhalten die AMI-ID auf der Amazon Web Services Management Console. Wenn Sie ein AMI aus AWS Marketplace verwenden, müssen Sie zuerst CloudFormation zur Verwendung in dieser CloudFormation-Vorlage abonnieren.
- Die CloudFormation-Vorlage arcgis-ami-linux.template.json.
Erforderliche Tasks
Vergewissern Sie sich, dass der AWS Systems Manager-Agent in dem Basis-AMI installiert ist, das Sie zum Erstellen eines ArcGIS Enterprise AMIs mithilfe dieser CloudFormation-Vorlage verwenden möchten. Der AWS Systems Manager-Agent ist in den Basis-Ubuntu-AMIs von AWS standardmäßig installiert. Wenn Sie jedoch ein anderes AMI als ein AWS-Basis-AMI für Ubuntu verwenden möchten, müssen Sie den AWS Systems Manager-Agenten im Basis-AMI des Linux-Betriebssystems konfigurieren. Gehen Sie wie folgt vor, um AWS Systems Manager in einem Basis-AMI des Linux-Betriebssystems zu installieren:
- Erstellen Sie eine Amazon Elastic Compute Cloud (EC2)-Instanz über ein Basis-AMI mithilfe der AWS Management Console.
- Installieren Sie den AWS Systems Manager-Agent auf der EC2-Instanz, die Sie im vorherigen Schritt erstellt haben.
Anweisungen hierzu finden Sie in der Dokumentation zu AWS.
- Erstellen Sie ein AMI über die EC2-Instanz mithilfe der AWS Management Console.
- Verwenden Sie das im vorherigen Schritt erstellte AMI in dieser CloudFormation-Vorlage, um ein ArcGIS Enterprise AMI zu erstellen.
Parameter
Die folgenden Tabellen enthalten Beschreibungen der Parameter, die in dieser CloudFormation-Vorlage verwendet werden. Die Tabellen sind nach Parametertyp gruppiert.
Amazon EC2-Konfiguration
| Parametername | Erforderlich/nicht erforderlich | Parameterbeschreibung |
|---|---|---|
Source Amazon Machine Image (AMI) ID | Erforderlich | Geben Sie die Quell-ID des Amazon Machine Image (AMI)s an. Eine Liste mit unterstützten Linux-Betriebssystemen finden Sie unter Bei Verwendung von CloudFormation zur Bereitstellung von ArcGIS auf AWS unterstützte Betriebssysteme. Wenn Sie ein Basis-AMI aus AWS Marketplace verwenden, müssen Sie zur Verwendung in dieser Vorlage zuerst AMI abonnieren. Vergewissern Sie sich, dass AWS Systems Manager im Quellen-AMI konfiguriert ist. |
Target AMI name | Erforderlich | Geben Sie einen Namen für das AMI an. Er muss mit einem Buchstaben beginnen. Der Name muss aus alphanumerischen Zeichen bestehen und kann Unterstriche (_) oder Bindestriche (-) enthalten. Es muss mindestens 6 Zeichen und darf maximal 127 Zeichen enthalten. Der AMI-Name muss zudem eindeutig sein. |
Target AMI description | Erforderlich | Geben Sie eine Beschreibung für das AMI an. Er muss mit einem Buchstaben beginnen. Die Beschreibung muss aus alphanumerischen Zeichen bestehen und kann Unterstriche (_), geschweifte Klammern ({}) und Doppelpunkte (:) enthalten. Es muss mindestens 6 Zeichen und darf maximal 255 Zeichen enthalten. Die AMI-Standardbeschreibung lautet EsriLinuxAmi_from_{{SourceAmiId}}_on_{{global:DATE_TIME}}. Wenn Sie die Standardbeschreibung verwenden, wird {{SoureAmiId}} durch den Parameterwert für die Quell-ID des Amazon Machine Images und {{global:DATE_TIME}} durch das vom AMI erstellte Datum und die entsprechende Uhrzeit ersetzt. |
EC2 Instance Type | Erforderlich | Geben Sie einen EC2-Instanztyp an. Die Standardeinstellung ist "m5.2xlarge". Der Instanztyp muss mindestens 4 vCPUs und 8 GB RAM aufweisen. |
Device Name for EBS Volume | Erforderlich | Wählen Sie den Gerätenamen für das EBS-Volume im Image an. Sie müssen den Gerätenamen auswählen, der vom AMI verwendet wird, das Sie mit dem Parameter für die Quell-ID des Amazon Machine Images angegeben haben. Die verfügbaren Werte lauten wie folgt:
|
EBS Volume Size | Erforderlich | Geben Sie die Größe (in GB) eines EBS-Volumes an, das in das Image eingebunden wird. Vergewissern Sie sich, dass dieses Volume gleich groß oder größer als das Snapshot-Volume ist, das an das Quell-AMI angefügt wurde, das Sie für den Source Amazon Machine Image (AMI) ID-Parameter angegeben haben. |
EC2 Instance Keypair Name | Erforderlich | Wählen Sie den Namen eines EC2-Schlüsselpaars für den Remotezugriff auf EC2-Instanzen aus. |
VPC ID | Erforderlich | Wählen Sie eine VPC-ID aus. Wenn Sie eine VPC erstellen müssen, dann können Sie eine der VPC-Beispielvorlagen verwenden: VPC mit öffentlichen Subnetzen oder VPC mit öffentlichen und privaten Subnetzen und einem NAT-Gateway. |
Subnet ID | Erforderlich | Wählen Sie eine Subnetz-ID aus. Die Subnetz-ID, die Sie auswählen, muss in der VPC liegen, die Sie oben ausgewählt haben. Wenn Sie eine Esri CloudFormation-Vorlage zum Erstellen der VPC verwendet haben, dann können Sie die Subnetz-ID aus den Ausgabeparametern dieser Vorlage abrufen. |
ArcGIS-Softwarekonfiguration
| Parametername | Erforderlich/nicht erforderlich | Parameterbeschreibung |
|---|---|---|
ArcGIS Enterprise Component | Erforderlich | Wählen Sie die ArcGIS Enterprise-Komponente aus, die im AMI installiert werden soll. Verfügbar sind die folgenden Werte:
Hinweis:Wenn Sie ArcGIS Enterprise Base auswählen, sind Portal for ArcGIS mit ArcGIS Web Adaptor mit einem Kontextnamensportal, ArcGIS Server mit ArcGIS Web Adaptor mit einem Kontextnamensserver und ArcGIS Data Store im AMI installiert. |
ArcGIS GeoEvent Server | Optional | Geben Sie an, ob ArcGIS GeoEvent Server installiert werden soll. Verfügbare Werte sind true und false. Hinweis:Dieser Parameter ist nur anwendbar, wenn Sie den Parameter ArcGIS Enterprise Component auf ArcGIS Enterprise Base oder ArcGIS Server festlegen. |
ArcGIS Web Adaptor | Optional | Geben Sie an, ob ArcGIS Web Adaptor installiert werden soll. Verfügbare Werte sind true und false. Hinweis:Dieser Parameter wird ignoriert, wenn Sie den Parameter ArcGIS Enterprise Component auf einen der folgenden Werte festlegen:
|
ArcGIS Web Adaptor Name | Bedingt | Geben Sie einen ArcGIS Web Adaptor-Kontextnamen an. Dieser wird im Portal, in ArcGIS Server oder in der ArcGIS Mission Server-URL angezeigt. Dieser Name muss mit einem Buchstaben beginnen und darf nur alphanumerische Zeichen enthalten. Dieser Parameter ist erforderlich, wenn Sie den Parameter ArcGIS Web Adaptor auf true festlegen, und wird ignoriert, wenn Sie den Parameter ArcGIS Web Adaptor auf false festlegen. |
Ausgaben
Wenn Ihr Stack erfolgreich erstellt wurde, werden die folgenden Ausgabeparameter auf der Registerkarte Outputs des CloudFormation-Stacks in AWS Management Console angezeigt.
| Ausgabename | Ausgabebeschreibung |
|---|---|
TargetAMIName | Der Name des AMIs, das mit dieser CloudFormation-Vorlage erstellt wurde. Sie können die AMI-ID in der AWS Management Console mithilfe des AMI-Namens abrufen. |
DeploymentLogsURL | Dies ist die URL für die Amazon CloudWatch-Protokolle, in der alle Bereitstellungsprotokolle gespeichert werden. In diesen Protokollen finden Sie Informationen zur Problembehebung, wenn Ihre Bereitstellung fehlgeschlagen ist. |
Überlegungen
Nach dem Erstellen eines CloudFormation-Stacks für ein benutzerdefiniertes AMI sind die folgenden wichtigen Punkte zu beachten:
- Mit dieser Vorlage werden ein CloudFormation-Stack und ein benutzerdefiniertes AMI erstellt.
- Rufen Sie nach dem Erstellen eines CloudFormation-Stacks die AMI-ID von der AWS Management Console ab, indem Sie den Parameterwert der TargetAMIName CloudFormation-Ausgabe verwenden.
- Sie können den CloudFormation-Stack löschen, nachdem das AMI erstellt wurde. Dadurch wird das AMI, das Sie mit dem CloudFormation-Stack erstellt haben, nicht gelöscht. Verwenden Sie zum Löschen des Stacks (oder des AMIs) die AWS Management Console.
Problembehandlung
Wenn Sie beim Erstellen dieses CloudFormation-Stacks Fehler feststellen, dann finden Sie entsprechende Informationen unter Problembehandlung bei ArcGIS-Bereitstellungen unter AWS.