Mit dem Befehl PREP von ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services werden mehrere wichtige vorab erforderliche Aufgaben für eine ArcGIS Enterprise-Bereitstellung in Amazon Web Services (AWS) automatisiert. Bereiten Sie zunächst eine JSON-Datei vor, indem Sie die Parameter angeben, und führen Sie dann den Befehl PREP aus, um folgende Aufgaben zu erledigen:
- Erstellen Sie einen Netzwerkstapel und einen Amazon Simple Storage Service (S3)-Bucket für die Bereitstellung, wenn noch kein Bucket vorhanden ist. Der S3-Bucket wird von Cloud Builder verwaltet.
- Erstellen Sie eine Amazon Virtual Private Cloud (VPC) für Ihre Bereitstellung.
- Laden Sie alle erforderlichen Autorisierungsdateien und SSL-Zertifikate in den S3-Bucket hoch.
- Importieren Sie das SSL-Zertifikat in AWS Certificate Manager.
Sie müssen den Befehl PREP nur unter folgenden Umständen erneut ausführen:
- Sie möchten eine weitere Bereitstellung in einer anderen Region oder in einem separaten Netzwerk erstellen.
- Sie verfügen über mehrere AWS-Konten und möchten Bereitstellungen für verschiedene Konten erstellen.
- Sie müssen das SSL-Zertifikat für die Bereitstellung aktualisieren.
- Die ArcGIS-Lizenzen sind abgelaufen und Sie müssen neue Lizenzdateien hochladen.
Vom Befehl PREP werden Informationen in eine Textdatei auf der lokalen Festplatte zurückgegeben.
- Laden Sie das ArcGIS Enterprise Cloud Builder for Amazon Web Services-Setup von My Esri herunter, und legen Sie es auf der lokalen Festplatte ab.
- Doppelklicken Sie auf die Datei Setup.exe, um die Installation zu starten. Befolgen Sie die Anweisungen auf den jeweiligen Bildschirmen, um die Installation abzuschließen.
Das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS und die zugehörigen Dateien und Beispiele werden in dem bei der Installation angegebenen Speicherort installiert.
- Verschieben Sie das SSL-Zertifikat (.pfx) und die Lizenzdateien (.prvc oder .ecp für ArcGIS Server und .json für Portal for ArcGIS) auf den Computer, auf dem Sie gerade das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS extrahiert haben.
- Wenn Sie die mit dem Dienstprogramm bereitgestellten .json-Beispieldateien ändern und verwenden möchten, erstellen Sie Kopien der Dateien im Ordner Configuration\PrepSamples. Achten Sie darauf, die Kopien in einem Unterordner unter dem Ordner Configuration zu speichern.
- Bevor Sie den Befehl PREP mit dem Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS ausführen, ändern Sie eine der Beispielvorbereitungsdateien, oder erstellen Sie eine eigene .json-Vorbereitungsdatei.
Um in einem Schritt eine VPC und einen S3-Bucket zu erstellen und das SSL-Zertifikat sowie die ArcGIS-Lizenzdateien hochzuladen, ändern Sie die Kopie der Beispieldatei allprep.json, oder erstellen Sie eine eigene .json-Vorbereitungsdatei, die die im folgenden Beispiel dargestellten Parameter enthält. Öffnen Sie die Datei in einem Texteditor, legen Sie die Informationen des Kontos und der Bereitstellung in den Parametern fest, und speichern Sie die Änderungen. Eine Beschreibung der einzelnen Parameter finden Sie unter Parameter im ArcGIS Enterprise Cloud Builder CLI for AWS.
In diesem Beispiel stellt das Dienstprogramm die Verbindung mit dem AWS-Konto über den Zugriffsschlüssel und den geheimen Zugriffsschlüssel des Kontos her. Die Lizenzdateien und das SSL-Zertifikat werden aus den angegebenen lokalen Ordnern kopiert und in dem von ArcGIS Enterprise Cloud Builder for AWS verwalteten S3-Bucket der Bereitstellung platziert. Außerdem wird in den Verfügbarkeitszonen "ap-northeast-1b" und "ap-northeast-1a" eine VPC erstellt.
Es ist möglich, dass sich alle Ihre ArcGIS Server-Lizenzen in derselben Datei befinden.
{ "AWSCredentials": { "AWSAccessKey": "ABCDEFGHIMI4YCPABC", "AWSSecretKey": "ABCDLZDYIzZuXHlWHOPhMqrTmABCD", "AWSRegion": "ap-northeast-1" }, "NetworkStack": { "StackName": "EnterpriseVPC", "AZs": "ap-northeast-1b,ap-northeast-1a", "CreateFlag":true }, "ArcGISEnterpriseFiles": { "PortalLicense": "C:\\ArcGISLicenses\\Your_Portal_License.json", "ServerLicense": "C:\\ArcGISLicenses\\Your_GIS_Server_License.prvc", "GeoAnalyticsLicense": "C:\\ArcGISLicenses\\Your_GeoAnalytics_Server_License.prvc", "NotebookServerLicense": "C:\\ArcGISLicenses\\Your_Notebook_Server_License.prvc", "MissionServerLicense": "C:\\ArcGISLicenses\\Your_Mission_Server_License.prvc", "ImageServerLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc", "RasterAnalyticsLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc", "ImageHostingLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc", "GeoEventLicense": "C:\\ArcGISLicenses\\Your_GeoEvent_Server_License.prvc", "WorkflowManagerLicense": "C:\\ArcGISLicenses\\Your_Workflow_Manager_License.prvc", "SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx", "SSLCertPassword": "changeit" } } - Öffnen Sie eine Eingabeaufforderung, und wechseln Sie (cd) zu dem Ordner, in dem Sie das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS und die zugehörigen Dateien installiert haben. Führen Sie das Dienstprogramm mit dem Befehl PREP aus: cloudbuilder.exe PREP -j <prepfilename.json>
Um beispielsweise eine Datei mit dem Namen myallprep.json zu verwenden, die Sie unter dem Ordner "Configuration" von ArcGIS Enterprise Cloud Builder CLI for AWS in einem neuen Unterordner für die Vorbereitungsdatei abgelegt haben, geben Sie Folgendes ein:
cloudbuilder.exe PREP -j Configuration\MyPrepFiles\myallprep.json
- Navigieren Sie zur Ausgabedatei des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS (im Format PREP_<date><time>.json) im Ordner CloudBuilder\AWS\CLI\Output auf der lokalen Festplatte.
Diese Datei enthält Informationen, die Sie benötigen, wenn Sie die Bereitstellung erstellen.
Die Ausgabe, die beim Ausführen der Beispieldatei in Schritt 5 erstellt wird, enthält eine ID und zwei Subnet-IDs für eine neue VPC, den Namen des S3-Buckets und den eindeutigen Amazon-Ressourcennamen (ARN), der für das SSL-Zertifikat erstellt wurde.
"NetworkStack": { "VPCId": "vpc-z9fb11ba", "subnet1": "subnet-z319acee", "subnet2": "subnet-f4fc658f" }, "DeploymentDetails": { "PortalLicense": "resources/licenses/<version>/portal/Your_Portal_License.json", "ServerLicense": "resources/licenses/<version>/server/Your_GIS_Server_License.prvc", "GeoAnalyticsLicense": "resources/licenses/<version>/geoanalytics/Your_GeoAnalytics_Server_License.prvc", "NotebookServerLicense": "resources/licenses/<version>/notebookserver/Your_Notebook_Server_License.prvc", "MissionServerLicense": "resources/licenses/<version>/missionserver/Your_Mission_Server_License.prvc", "ImageServerLicense": "resources/licenses/<version>/image/Your_Image_Server_License.prvc", "RasterAnalyticsLicense": "resources/licenses/<version>//rasteranalytics/Your_Image_Server_License.prvc", "ImageHostingLicense": "resources/licenses/<version>//imagehosting/Your_Image_Server_License.prvc", "GeoEventLicense": "resources/licenses/<version>/geoevent/Your_GeoEvent_Server_License.prvc", "WorkflowManagerLicense": "resources/licenses/<version>/workflow/Your_Workflow_Manager_License.prvc", "SSLCertificateFile": "resources/sslcerts/wildcard_yourdomain_com.pfx", "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "DeploymentBucket": "esri-aws-1234567890" }Der Inhalt der Ausgabedatei kann abhängig von den Informationen, die Sie in der Konfigurationsdatei angegeben haben, unterschiedlich sein.
Sie können nun eine Bereitstellung mit der Befehlszeilenschnittstelle erstellen.