Skip To Content

Erstellen von Bereitstellungen mit dem Befehl CREATE von ArcGIS Enterprise Cloud Builder CLI for AWS

Mit dem Befehl CREATE im Dienstprogramm ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) wird eine ArcGIS Enterprise-Basisbereitstellung mit der Option zur Erstellung eines zusätzlichen verbundenen Computers für jede ArcGIS Server-Lizenzierungsrolle erstellt. Nach der Ausführung des Befehls zum Erstellen der ersten Bereitstellung können Sie den Befehl später erneut ausführen, um weitere ArcGIS Server-Sites hinzuzufügen.

Hinweis:

Stellen Sie vor der Ausführung des Befehls CREATE sicher, dass die AWS-Organisation über ausreichende Ressourcen verfügt, damit die neuen Maschinen von der Bereitstellung erstellt werden können. Der Befehl ist nicht erfolgreich, wenn die neue Bereitstellung das Limit der Organisation überschreitet.

Sie können eine Kopie einer Esri JSON-Beispieldatei im Ordner CreateSamples öffnen und die Datei bearbeiten, um Ihre Parameter einzufügen. Wählen Sie beispielsweise zum Erstellen einer Bereitstellung, die für Raster-Analysen optimiert wurde, die Datei baseenterpriseallinonewithra.json aus.

Alternativ können Sie eine zusammenfassende JSON-Datei, die Sie über die App ArcGIS Enterprise Cloud Builder for AWS heruntergeladen haben, als Vorlage für neue Bereitstellungen verwenden. Allerdings können Sie mit ArcGIS Enterprise Cloud Builder CLI for AWS die mit der App ArcGIS Enterprise Cloud Builder for AWS erstellten Bereitstellungen nicht hinzufügen.

Sie müssen mehrere Schritte in der AWS Management Console befolgen, bevor Sie den Befehl CREATE ausführen. Die Ergebnisse dieser Schritte verwenden Sie als Parametereinstellungen in der JSON-Datei.

  1. Melden Sie sich mit dem Konto, das Sie bei der Vorbereitung der Bereitstellung verwendet haben, bei der AWS Management Console an. Stellen Sie sicher, dass Sie sich in der Region befinden, die Sie im vorherigen Abschnitt mit dem Parameter "AWSRegion" angegeben haben.
  2. Weisen Sie in ArcGIS Enterprise für eine ArcGIS GeoEvent Server eine neue Elastic IP-Adresse für AWS-Basisbereitstellungen mit einem Computer und den Amazon Virtual Private Cloud (VPC)-Computer zu. Kopieren Sie die entsprechende Allocation ID, die im Format eipalloc-xxxxxxxx angegeben wird. Fügen Sie die ID in der JSON-Datei als Wert für den Parameter SiteEIPAllocationID unter BaseEnterprise ein.

    Wenn Sie eine ArcGIS Enterprise-Basisbereitstellung mit einem Computer erstellen, fahren Sie mit Schritt 5 fort.

  3. ArcGIS Server und die hoch verfügbaren ArcGIS EnterpriseBereitstellungen erfordern jeweils einen Load Balancer. Sie können die Load Balancer wie unten beschrieben erstellen oder vorhandene Load Balancer verwenden. Wenn Sie vorhandene Load Balancer verwenden möchten, fahren Sie mit Schritt 4 fort.
    • Sie können mit dem Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS einen Load Balancer erstellen lassen, wenn Ihre Organisation zum Verwalten ihres DNS (Domain Name Service) Amazon Route 53 verwendet und Ihr AWS-Konto über die Berechtigung zum Verwalten des DNS verfügt. Dies ist eine seltene Konfiguration. Deshalb müssen Sie wahrscheinlich zunächst den Load Balancer erstellen, wenn Sie sich nicht sicher sind, ob Sie über diese Konfiguration und Berechtigung verfügen.
    • Erstellen Sie den Load Balancer mit einer AWS CloudFormation-Beispielvorlage von Esri (empfohlen) oder in der AWS Management Console. Wenn Sie einen Domänennamen erworben haben, der nicht aus AWS stammt, müssen Sie die Domäne dem Load Balancer zuordnen, bevor Sie die Bereitstellung mit dem Dienstprogramm erstellen. Wenn Sie einen Load Balancer mit der AWS Management Console erstellen, achten Sie darauf, dieselbe VPC wie die Bereitstellung zu verwenden, und konfigurieren Sie einen HTTPS-Listener für die Load Balancer.

      Das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS kann den Load Balancer verwenden, den Sie mit der CloudFormation-Vorlage oder in der AWS Management Console erstellt haben.

    Nachdem Sie die Load Balancer erstellt haben, notieren Sie sich die resultierenden DNS-Namen, die mit *.elb.amazonaws.com enden. Sie benötigen diese Informationen für den nächsten Schritt.

  4. Ordnen Sie die DNS-Namen der Load Balancer Ihrer Domäne zu. Wenn Sie den AWS Route 53-Service verwenden, navigieren Sie zu dieser Seite. Registrieren Sie eine Domäne, wenn Sie dies nicht bereits zuvor getan haben, und erstellen Sie einen Datensatz mit dem gewünschten Domänennamen der Site. Wenn Sie einen anderen Service für die DNS-Zuordnung verwenden, navigieren Sie zu der entsprechenden Site. Legen Sie in jedem dieser Fälle CNAME als Typ für den Namen der Basisbereitstellungs-Site fest, und fügen Sie den DNS-Namen, den Sie in Schritt 2 erhalten haben, als Wert ein. Wiederholen Sie dies, um die DNS-Namen der einzelnen Load Balancer den jeweiligen ArcGIS Server-Sites zuzuordnen.

    Wenn Sie beispielsweise eine Bereitstellung erstellen, die für Raster-Analysen optimiert wurde, müssen Sie den DNS-Namen des Load Balancers, den Sie für den Raster-Analyseserver erstellt haben, der ArcGIS Image Server-Site zuordnen.

  5. Fügen Sie die Site-Domänennamen (z. B. base.domain.com und raster.domain.com) und die Werte für Name der zusätzlichen Load Balancer der JSON-Datei im entsprechenden Abschnitt als Werte für SiteDomain hinzu.

    Wenn Sie etwa die Beispieldatei baseenterpriseallinonewithra.json ändern, wird der VPC-ID-Wert im Abschnitt "Default" festgelegt. Die anderen Werte werden wie folgt in den Abschnitten "BaseEnterprise" und "RasterAnalytics" festgelegt:

    "Default" :{  
    	  "VPCId": "vpc-0011xxxxx",	 
    	  "DriveSizeRoot": "100",
    	  "KeyName": "YOURKEYNAME",
    	  "FSInstanceType": "m4.xlarge",
    	  "ASInstanceType": "m4.xlarge",
    	  "SecondaryInstances": "2",	
    	  "BDSInstanceType": "m4.xlarge",
    	  "BDSInstances": "0",	
    	  "DBEngine": "postgres",
    	  "DBInstanceClass": "db.m4.large",
    	  "DBAllocatedStorage": "200",
    	  "DeploymentBucket": "enterprisefiles",
    	  "StoreType": "CloudStore",
    	  "SiteAdmin": "admin",
    	  "SiteAdminPassword": "changeit",	
    	  "RunAsUserPassword": "P@ssw0rd123",
    	  "SSLCertificateFile": "wildcard_yourdomain_com.pfx",
    	  "SSLCertPassword": "AvertUR1s",
    	  "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    	  "PostInstallationScript": "none"
    	},
    "BaseEnterprise":{
      "SiteEIPAllocationID": "eipalloc-xxxxxxxx",	
      "InstanceType": "m4.xlarge",	
      "SiteDomain": "basedep.yourdomain.com",
      "PortalLicenseFile": "Your_Portal_License.json",
      "UserLicenseTypeID" : "My_User_Type_UT"
      "ServerLicenseFile":	"Your_GIS_Server_License.prvc",	  
      "Type": "AllInOne"
     },    
    "RasterAnalytics":{
      "ServerLicenseFile": "Your_Image_Server_License.prvc",	
      "ELBName": "your-raster-elb",
      "SiteDomain": "raster.yourdomain.com",	
      "CloudStoreS3BucketPath": "yourbucket/yourfolder",
      "Federate":true,
    }
  6. Erstellen Sie ein neues Schlüsselpaar in AWS. Fügen Sie den Namen des Schlüsselpaares in der JSON-Datei als Wert für den Parameter KeyName hinzu.
  7. Ändern Sie ggf. die restlichen Parameter in der JSON-Datei. Erläuterungen dazu finden Sie in der vollständigen Parameterliste für die ArcGIS Enterprise Cloud Builder CLI for AWS.
  8. Speichern Sie die geänderte JSON-Datei. Kehren Sie zur Konsole der Eingabeaufforderung zurück, und führen Sie den Befehl CREATE aus: cloudbuilder.exe CREATE -j <createfilename.json>

    Das Dienstprogramm erstellt eine Ausgabedatei im Ordner ArcGIS Enterprise Cloud Builder CLI for AWS Output der Befehlszeilenschnittstelle in einem Unterordner, der nach dem Parameter DeploymentName benannt wurde. Bei jeder Ausführung des Befehls CREATE für dieselbe ArcGIS Enterprise-Bereitstellung werden die Ausgabedateien im entsprechenden Unterordner der Bereitstellung gespeichert. Die Dateien erhalten den Namen <DeploymentName>_<batchID>.json, wobei die Zeichenfolge batchID einen Zeitstempel der Dateierstellung enthält. Alte Ausgabedateien werden vom Dienstprogramm nie gelöscht.

    Protokolldateien werden in einem Logs-Ordner in dem Verzeichnis erstellt, in dem Sie ArcGIS Enterprise Cloud Builder for Amazon Web Services extrahiert haben.

    Im Folgenden finden Sie ein Beispiel für den Inhalt einer Ausgabedatei, die generiert wird, wenn Sie den Befehl CREATE ausführen, um eine Basisbereitstellung und die ArcGIS GeoAnalytics Server-, Raster-Analyse-Server-, ArcGIS GIS Server- und ArcGIS GeoEvent Server-Sites zu erstellen:

    "BaseEnterprise":{
               "PortalURL": "http://enterprise.yourdomain.com/portal/home",
               "ServerURL": "http://enterprise.yourdomain.com/server/manager"	 
       },
       "GeoAnalytics":{
                "ServerURL": "http://geoanalytics.yourdomain.com/arcgis/manager"	
       },
       "RasterAnalytics":{
                "ServerURL": "http://rasteranalytics.yourdomain.com/arcgis/manager"
       },
       "Server":{     
           "ServerURL": "http://server.yourdomain.com/arcgis"
       },
       "GeoEvent":{
               "ServerURL": "http://geoevent.yourdomain.com/server/manager",
               "GeoEventServerURL": "http://geoevent.yourdomain.com:6143/geoevent/manager"
       }

    Beachten Sie, dass der Inhalt der Ausgabedatei abhängig von den Informationen, die Sie in der JSON-Konfigurationsdatei angegeben haben, unterschiedlich sein kann.

  9. Nachdem Sie den Befehl ausgeführt und eine ArcGIS Enterprise-Bereitstellung erstellt haben, können Sie den Befehl erneut ausführen, um weitere ArcGIS Server-Sites zu erstellen. Aktualisieren Sie dieselbe Konfigurationsdatei für die Bereitstellung, und führen Sie den Befehl CREATE erneut aus. Die Komponenten, die bereits bereitgestellt wurden, werden vom Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS übersprungen; nur die neuen Komponenten werden hinzugefügt.