Skip To Content

Verwenden von CloudFormation zum Bereitstellen eines ArcGIS Data Store im Cluster-Modus

Die Esri Amazon Web Services (AWS) CloudFormation-Vorlage arcgis-datastore-cluster.template.json erstellt einen ArcGIS Data Store vom Typ "Kachel-Cache" oder "spatiotemporal" auf mehreren Amazon Elastic Compute Cloud (EC2)-Instanzen. Indem Sie einem Cluster aus mehreren Instanzen verwenden, können Sie den Data Store skalieren, um den Speicherbedarf zu erfüllen.

Diese Vorlage konfiguriert die ArcGIS Data Store-Instanzen in einer AWS Auto Scaling-Gruppe. Dies bietet zusätzliche Vorteile, wie zum Beispiel Kapazitätsplanung basierend auf bestimmten Kriterien, bessere Fehlertoleranz, bessere Verfügbarkeit und besseres Kostenmanagement.

Tipp:
Verwenden Sie diese Vorlage beim Erstellen einer ArcGIS Enterprise-Bereitstellung, wie in Verwenden von CloudFormation zum Bereitstellen von ArcGIS Enterprise-Komponenten auf getrennten Computern beschrieben.

Bei Verwendung dieser Vorlage haben Sie die folgenden Optionen für die Speicherung der Sicherung:

  • Speichern Sie die Sicherungsdateien in Amazon Simple Storage Service (S3).
  • Speichern Sie die Sicherungsdateien auf einem separaten Dateiserver (EC2-Instanz).

Mit dieser Vorlage wird die folgende Architektur in Amazon Web Services erstellt:

Big Data Store vom Typ "Kachel-Cache" oder "spatiotemporal" mit Computern in einer Auto Scaling-Gruppe

Das obige Diagramm zeigt, dass Sicherungen entweder in einem EC2-Dateiserver oder in einem S3-Bucket, aber nicht an beiden Orten gespeichert werden.

Lizenz:

Die Verwendung einiger Symbole im Diagramm wurde durch Amazon Web Services genehmigt.

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

Bevor diese Vorlage ausgeführt wird, benötigen Sie die folgenden Elemente:

  • Ein Amazon Web Services-Konto.

    Das Konto muss Zugriff auf AWS-Basisservices haben, wie zum Beispiel CloudFormation, Amazon Elastic Compute Cloud (EC2), Amazon Virtual Private Cloud (VPC), Amazon Simple Storage Service (S3), Systems Manager, Amazon CloudWatch, Lambda, AWS Identity and Access Management (IAM), Amazon DynamoDB, Secrets Manager, AWS Certificate Manager und Amazon Relational Database Service (RDS).

  • Wenn Sie eine Bereitstellung auf Ubuntu EC2-Instanzen in AWS GovCloud erstellen, dann benötigen Sie eine AMI-ID. Wenn Sie die kanonische Basis-Ubuntu-AMI verwenden möchten, dann befolgen Sie die Anweisungen unter Esri Amazon Web Services CloudFormation-Vorlagen, um die ID zu ermitteln.
  • 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 CloudFormation-Vorlage arcgis-datastore-cluster.template.json.

Erforderliche Tasks

Bevor diese Vorlage ausgeführt wird, müssen Sie die folgenden Schritte durchführen:

  • Sie benötigen eine ArcGIS GIS Server-Site, die als Hosting-Server für ein ArcGIS Enterprise-Portal verwendet werden soll. Stellen Sie sicher, dass bei der Site nicht bereits ein ArcGIS Data Store des Typs, der mit dieser Vorlage erstellt werden soll, registriert ist.

    Zum Erstellen der Site können Sie die Vorlage für eine ArcGIS Server-Site mit einem Computer oder die Vorlage für eine ArcGIS Server-Site mit mehreren Computern verwenden.

  • Konfigurieren Sie Kennwörter in AWS Secrets Manager (optional, aber empfohlen).

    Die Kennwörter für Konten, wie zum Beispiel den Benutzernamen des Site-Administrators und das Windows-Kennwort für den arcgis-Benutzer, können Sie in AWS Secrets Manager konfigurieren. Damit wird Ihnen ein geheimer Amazon-Ressourcenname (ARN) bereitgestellt. Verwenden Sie den ARN anstelle eines Kennworts in den Vorlagenparametern, wenn Sie einen Stack starten. Wenn Sie AWS Secrets Manager nicht zum Speichern von Kennwörtern verwenden, dann müssen Sie in den Vorlagenparametern die Kennwörter in Klartext eingeben, wenn Sie den Stack starten.

    Hinweis:

    Beim Erstellen eines geheimen ARN in AWS Secrets Manager für ein Kennwort zur Verwendung mit Esri CloudFormation-Vorlagen müssen Sie Other types of secrets als Secret-Typ und die Option Plaintext verwenden. Weitere Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS.

Tipp:

Standardmäßig löscht CloudFormation bei einer fehlgeschlagenen Stack-Erstellung die teilweise erstellten Ressourcen. Dies ist hilfreich, da dabei in Ihrem Konto unbrauchbare Bereitstellungen entfernt werden, kann aber auch die Problembehandlung erschweren. Wenn der Stack in seinem fehlerhaften Zustand erhalten bleiben soll, dann deaktivieren Sie die Option Rollback bei Fehler für die Erstellung eines CloudFormation-Stacks, bevor Sie den Stack starten. Weitere Informationen finden Sie unter Festlegen von AWS CloudFormation-Optionen in der AWS-Hilfe.

Parameter

Die folgenden Tabellen enthalten Beschreibungen der Parameter, die in dieser CloudFormation-Vorlage verwendet werden. Die Tabellen sind nach Parametertyp gruppiert.

Amazon EC2 Configuration

ParameternameErforderlich?Parameterbeschreibung

Platform Type

Erforderlich

Wählen Sie die Betriebssystemplattform aus. Die folgenden Typen werden unterstützt:

  • Windows
  • Linux

Eine Liste mit bestimmten Betriebssystemversionen finden Sie unter Bei Verwendung von CloudFormation zur Bereitstellung von ArcGIS auf AWS unterstützte Betriebssysteme.

EC2 Instance AMI ID

Optional

Diesen Parameterwert können Sie leer lassen. In diesem Fall verwenden die CloudFormation-Vorlagen die aktuelle Amazon Machine Image (AMI)-ID für Microsoft Windows Server 2019 oder Ubuntu Server 20.04 LTS entsprechend dem ausgewählten Plattformtyp.

Hinweis:

Wenn Sie in AWS GovCloud auf einer Linux-Plattform bereitstellen, dann dürfen Sie diesen Parameter nicht leer lassen. Anweisungen zur Suche nach der ID für das Basis-Ubuntu AMI von Canonical finden Sie in den Esri Amazon Web Services CloudFormation-Vorlagen. Wenn Sie die Bereitstellung auf einem anderen unterstützten Linux-Betriebssystem als Ubuntu durchführen, können Sie die AMI-ID mithilfe der AWS Management Console finden.

Um ein eigenes benutzerdefiniertes AMI zu verwenden, geben Sie die AMI-ID mit einer der folgenden Methoden ein:

  • Geben Sie die AMI-ID im folgenden Format an: 'ami-xxxxx'.
  • Wenn Sie die AMI-ID im AWS SSM-Parameterspeicher gespeichert haben, dann geben Sie den SSM-Parameternamen im folgenden Format an: AWS'{{resolve:ssm:[a-zA-Z0-9_.-/]+:\d+}}'.

Wenn Sie ein benutzerdefiniertes AMI verwenden, dann stellen Sie sicher, dass es die folgenden Anforderungen erfüllt:

  • EC2-Instance-Metadaten-Service (mit Version V2 oder V1) muss aktiviert sein.
  • Die neueste Version von AWS Systems Manager (SSM) Agent muss installiert sein.
  • Wenn das benutzerdefinierte AMI ein Windows-Betriebssystem enthält, müssen die AWS-Tools für PowerShell installiert sein.

EC2 Instance Keypair Name

Erforderlich

Wählen Sie den Namen eines EC2-Schlüsselpaars für den Remotezugriff auf EC2-Instanzen aus.

Elastic IP Address Allocation ID

Optional

Geben Sie die Zuordnungs-ID einer Elastic IP-Adresse in diesem Format an: eipalloc-XXXXXXXX.

Sie benötigen eine Elastic IP-Adresse, um der Elastic IP-Adresse den Domänennamen der Site zuzuordnen und auf die EC2-Instanz über RDP/SSH von außerhalb der AWS-Umgebung zuzugreifen.

Wenn Sie der EC2-Instanz keine Elastic IP-Adresse zuordnen möchten, dann lassen Sie diesen Parameter leer.

Amazon VPC Configuration

ParameternameErforderlich?Parameterbeschreibung

VPC ID

Erforderlich

Wählen Sie eine VPC-ID aus.

Hinweis:

Dies muss dieselbe VPC sein wie bei der ArcGIS GIS Server-Site, der Sie diesen Data Store hinzufügen.

Subnet ID 1

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.

Subnet ID 2

Erforderlich

Wählen Sie eine zweite Subnetz-ID aus. Dies muss eine andere Subnetz-ID als die für den Parameter der Subnetz-ID 1 sein. Die Subnetz-ID, die Sie auswählen, muss in der VPC liegen, die Sie für diese Bereitstellung angegeben 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 Server Configuration

ParameternameErforderlich?Parameterbeschreibung

Site Administrator User Name

Erforderlich

Geben Sie einen Benutzernamen für den primären ArcGIS Server-Site-Administrator der ArcGIS GIS Server-Site an, die als Hosting-Server des Portals verwendet werden soll.

Site Administrator User Password

Erforderlich

Geben Sie das Kennwort für den primären ArcGIS Server Site-Administrator an. Sie können entweder ein Kennwort in Klartext oder den ARN Ihrer Secret-ID in AWS Secrets Manager eingeben. Weitere Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS.

Das Kennwort (bzw. die ID des geheimen Schlüssels), das Sie angeben, muss mit dem Kennwort (bzw. der Secret-ID) des vorhandenen primären Site-Administrators übereinstimmen.

ArcGIS Server EC2 Instance ID

Erforderlich

Wählen Sie die ID einer EC2-Instanz aus, auf der Ihre ArcGIS Server-Site konfiguriert wurde.

Hinweis:
Wenn Sie die Datenbank bei einer ArcGIS Server-Site mit mehreren Computern registrieren, können Sie die ID jeder EC2-Instanz in der ArcGIS Server-Site auswählen. Wählen Sie keinen EC2-Dateiserver aus.

ArcGIS Data Store Configuration

ParameternameErforderlich?Parameterbeschreibung

Type

Erforderlich

Wählen Sie den Typ des ArcGIS Data Store aus, der im Cluster-Modus bereitgestellt werden soll. Gültige Werte sind spatiotemporal oder tileCache.

Tipp:

Um einen Data Store vom Typ "relational" zu erstellen, verwenden Sie die Vorlage für einen Data Store mit einem Computer oder die Vorlage für einen Primär/Standby-Data-Store.

Number of EC2 instances

Erforderlich

Wählen Sie die Anzahl der EC2-Instanzen, die im Data-Store-Cluster enthalten sein sollen. Der Standardwert ist 3.

Gültige Werte sind 1, 3 oder 5.

Hinweis:

Wenn Sie eine größere Anzahl der EC2-Instanzen benötigen, dann verwenden Sie die AWS Management Console, um die AWS Auto Scaling-Gruppe so zu modifizieren, dass sie die erforderliche Anzahl der Instanzen enthält. Da ein Big Data Store vom Typ "spatiotemporal" eine ungerade Anzahl von Instanzen enthalten muss, wird empfohlen, dass Sie einen Cluster aus Data Stores vom Typ "Kachel-Cache" verwenden, der ebenfalls eine ungerade Anzahl von Instanzen enthält.

EC2 Instance Type

Erforderlich

Wählen Sie den Typ der EC2-Instanz für die ArcGIS Data Store-Instanzen aus. Die Standardeinstellung ist "m5.2xlarge".

Instanzen werden immer in einer AWS Auto Scaling-Gruppe konfiguriert.

EC2 Instance Root Drive Disk Space

Erforderlich

Geben Sie die Größe des Stammlaufwerks in GB an. Der Standardwert ist 100 GB. Das Minimum ist 100 GB. Das Maximum ist 1024 GB.

Windows arcgis user password

Bedingt

Geben Sie ein Kennwort für den arcgis-Benutzer an. Beim ArcGIS-Benutzer handelt es sich um lokale Windows-Anmeldedaten, die zum Ausführen der ArcGIS-Softwareservices verwendet werden. Daher ist dieses Kennwort nur erforderlich, wenn die Bereitstellung unter Windows erfolgt.

Sie können entweder ein Kennwort in Klartext oder den ARN Ihrer Secret-ID in AWS Secrets Manager eingeben.

Es ist eine Empfehlung, Ihre Kennwörter in AWS Secrets Manager zu verwalten. Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS.

Backup Store Type

Erforderlich

Wählen Sie den Typ des ArcGIS Data Store-Sicherungsspeichers aus. Der Standardtyp ist FileSystem.

  • FileSystem: ArcGIS Data Store-Sicherungen werden in einem ArcGIS-Dateiserver als EC2-Instanz gespeichert.
  • CloudStore: ArcGIS Data Store-Sicherungen werden in einem durch diesen Stack erstellten Amazon S3-Bucket gespeichert.

Backup Store EC2 Instance Type

Bedingt

Wählen Sie den Typ der EC2-Instanz für den ArcGIS Data Store-Sicherungscomputer aus. Der Standardinstanztyp ist m5.2xlarge.

Hinweis:

Dies ist nur dann erforderlich, wenn Sie FileSystem als Typ des Sicherungsspeichers angegeben haben.

Backup Store EC2 Instance Root Drive Disk Space

Bedingt

Geben Sie die Größe des Stammlaufwerks in GB an. Der Standardwert ist 100 GB. Das Minimum ist 100 GB. Das Maximum ist 1024 GB.

Hinweis:

Dies ist nur dann erforderlich, wenn Sie FileSystem als Typ des Sicherungsspeichers angegeben haben.

Ausgaben

Wenn Ihr Stack erfolgreich erstellt wurde, werden die folgenden Ausgabeparameter auf der Registerkarte Outputs des CloudFormation-Stacks in AWS Management Console angezeigt.

AusgabenameAusgabebeschreibung

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.

StopStackFunctionName

Dies ist die URL der Funktion Stop Stack Lambda. Diese Lambda-Funktion können Sie verwenden, um alle EC2-Instanzen im Stack zu beenden.

StartStackFunctionName

Dies ist die URL der Lambda-Funktion Start Stack Lambda. Diese Lambda-Funktion können Sie verwenden, um alle EC2-Instanzen im Stack, die Sie zuvor beendet haben, zu starten.

Überlegungen

Nach dem Erstellen eines CloudFormation-Stacks, der ArcGIS-Bereitstellungen enthält, sind die folgenden wichtigen Punkte zu beachten:

  • Wenn Sie ArcGIS Data Store unter AWS unter Verwendung dieser Vorlage bereitstellen, werden EC2-Instanzen in einer AWS Auto Scaling-Gruppe konfiguriert. Nachdem der Stack erstellt wurde, können Sie weitere Computer (EC2-Instanzen) zur ArcGIS Data Store-Site hinzufügen, indem Sie die Größe der AWS Auto Scaling-Gruppe anpassen. Verwenden Sie AWS Management Console, um die Kapazität der Auto Scaling-Gruppe zum Hinzufügen von Computern zu erhöhen. Um Computer zu entfernen, verringern Sie die Kapazität. In der AWS-Dokumentation finden Sie die Anweisungen zum Ändern der Kapazitätsgrenzen einer Auto Scaling-Gruppe zum Hinzufügen oder Entfernen von Computern in einem ArcGIS Data Store-Cluster.

    Tipp:

    Um die AWS Auto Scaling-Gruppe, die für einen CloudFormation-Stack erstellt wurde, zu finden, überprüfen Sie die Registerkarte Ressourcen des zugehörigen CloudFormation-Stacks. Die logische ID der Ressource lautet AutoScalingGroup.

    Obwohl es technisch möglich wäre, die Größe einer AWS Auto Scaling-Gruppe auf Null zu setzen, sollten Sie dennoch zumindest eine aktive Instanz in der Auto Scaling-Gruppe beibehalten, da andernfalls der ArcGIS Data Store nicht funktioniert.

  • Eine AWS-Ressource, die mit dieser CloudFormation-Vorlage erstellt wurde, sollten Sie nicht löschen. Die Information, welche AWS-Ressourcen mit dieser Vorlage erstellt wurden, finden Sie auf der Registerkarte Ressourcen dieses Stacks in der AWS Management Console. Jede Ressource, die mit einer Esri CloudFormation-Vorlage erstellt wurde, enthält auch Metadaten-Tags. Bei einigen der Ressourcen werden jedoch keine Tags in der AWS Management Console angezeigt.
  • Sie können die AWS Lambda-Funktionen, die in Ihren Stack-Ausgaben (siehe Abschnitt zu den Ausgaben dieser Seite) angezeigt werden, verwenden, um EC2-Instanzen in diesem Stack zu beenden, wenn sie nicht verwendet werden, und wieder zu starten, wenn sie benötigt werden. Diese Funktionen sind beim Steuern Ihrer Kosten eine nützliche Hilfe.

    Wenn Sie die Lambda-Funktion ausführen, um die EC2-Instanzen in der Bereitstellung zu beenden, dann gibt diese Funktion die Meldung zurück, dass die Instanzen beendet wurden. Wenn jedoch diese Instanzen Teil einer Auto Scaling-Gruppe sind, dann muss diese Funktion auch die Verbindung der Instanzen mit der Gruppe trennen. Dies kann bis zu 10 Minuten dauern. Warten Sie deshalb mindestens 10 Minuten, bevor Sie die Lambda-Startfunktion zum erneuten Starten der Bereitstellung ausführen.

  • Wenn Sie AWS Secrets Manager für Kennwörter wie das Benutzerkennwort des Site-Administrators oder das Windows-Kennwort für den ArcGIS-Benutzer, verwenden und diese Kennwörter später (nach dem Erstellen der Bereitstellung) ändern, müssen Sie den entsprechenden ARN von AWS Secrets Manager mit den aktualisierten Kennwörtern aktualisieren.

Problembehandlung

Wenn Sie beim Erstellen dieses CloudFormation-Stacks Fehler feststellen, dann finden Sie entsprechende Informationen unter Problembehandlung bei ArcGIS-Bereitstellungen unter AWS.