Skip To Content

Erstellen eines Amazon Machine Image mit ArcGIS unter einem Linux-Betriebssystem mithilfe von CloudFormation

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:

  1. Erstellen Sie eine Amazon Elastic Compute Cloud (EC2)-Instanz über ein Basis-AMI mithilfe der AWS Management Console.
  2. 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.

  3. Erstellen Sie ein AMI über die EC2-Instanz mithilfe der AWS Management Console.
  4. 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

ParameternameErforderlich/nicht erforderlichParameterbeschreibung

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:

  • /dev/sda1 (Standardwert)
  • /dev/xvda

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

ParameternameErforderlich/nicht erforderlichParameterbeschreibung

ArcGIS Enterprise Component

Erforderlich

Wählen Sie die ArcGIS Enterprise-Komponente aus, die im AMI installiert werden soll. Verfügbar sind die folgenden Werte:

  • ArcGIS Enterprise-Basis
  • Portal for ArcGIS
  • ArcGIS Server
  • ArcGIS Notebook Server
  • ArcGIS Mission Server
  • ArcGIS Workflow Manager
  • ArcGIS Data Store

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 Enterprise Base, da diese Option automatisch zwei Installationen von ArcGIS Web Adaptor enthält.
  • ArcGIS Data Store, da für ArcGIS Data Store kein Web Adaptor verwendet wird.

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.

AusgabenameAusgabebeschreibung

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.