Benutzerdefinierte Bereitstellung von Elastic Beanstalk-Anwendungen

In diesem Thema wird beschrieben, wie die Bereitstellungsmanifest-Datei für den Microsoft Windows-Container in Elastic Beanstalk die benutzerdefinierte Bereitstellung von Anwendungen unterstützt.

Benutzerdefinierte Anwendungsbereitstellungen sind eine wichtige Funktion für fortgeschrittene Benutzer, die die Leistung von Elastic Beanstalk zum Erstellen und Verwalten ihrerAWSRessourcen, möchten aber vollständige Kontrolle darüber, wie ihre Anwendung bereitgestellt wird. Für eine benutzerdefinierte Anwendungsbereitstellung erstellen Sie Windows PowerShell-Skripte für die drei verschiedenen Aktionen, die Elastic Beanstalk durchführt. Die Installationsaktion wird verwendet, wenn eine Bereitstellung begonnen wird. Die Neustartaktion kommt zum Einsatz, wenn die RestartAppServer-API entweder vom Toolkit oder über die Webkonsole aufgerufen wird. Die Aktion zum Deinstallieren wird auf vorherige Bereitstellungen angewendet, wenn eine neue Bereitstellung zur Verfügung steht.

Beispiel: Sie verfügen über eine ASP.NET-Anwendung, die Sie bereitstellen möchten, und Ihr Dokumentationsteam hat eine statische Website geschrieben, die in die Bereitstellung mit eingeschlossen werden soll. Um dies durchzuführen, kann Ihre Bereitstellungsmanifestdatei so geschrieben werden:

{
  "manifestVersion": 1,
  "deployments": {

    "msDeploy": [
      {
        "name": "app",
        "parameters": {
          "appBundle": "CoolApp.zip",
          "iisPath": "/"
        }
      }
    ],
    "custom": [
      {
        "name": "PowerShellDocs",
        "scripts": {
          "install": {
            "file": "install.ps1"
          },
          "restart": {
            "file": "restart.ps1"
          },
          "uninstall": {
            "file": "uninstall.ps1"
          }
        }
      }
    ]
  }
}

Die aufgeführten Skripts für jede Aktion müssen sich in dem Anwendungspaket befinden, das sich auf die Bereitstellungsmanifestdatei bezieht. Für dieses Beispiel enthält das Anwendungspaket auch eine documentation.zip-Datei mit einer statischen Website, die von Ihrem Dokumentationsteam erstellt wurde.

Das install.ps1-Skript extrahiert die ZIP-Datei und richtet den IIS-Pfad ein.

Add-Type -assembly "system.io.compression.filesystem"
[io.compression.zipfile]::ExtractToDirectory('./documentation.zip', 'c:\inetpub\wwwroot\documentation')

powershell.exe -Command {New-WebApplication -Name documentation -PhysicalPath  c:\inetpub\wwwroot\documentation -Force}

Da Ihre Anwendung in IIS ausgeführt wird, wird durch die Neustartaktion ein Zurücksetzen des IIS ausgelöst.

iisreset /timeout:1

Zum Deinstallieren von Skripten müssen alle Einstellungen und Dateien, die während der Installationsstufe verwendet wurden, gelöscht werden. Auf diese Weise können Sie verhindern, dass es bei der Installation der neuen Version zu einer Kollision mit vorherigen Bereitstellungen kommt. In diesem Beispiel müssen Sie die IIS-Anwendung für die statische Website sowie die Website-Dateien entfernen.

powershell.exe -Command {Remove-WebApplication -Name documentation}
Remove-Item -Recurse -Force 'c:\inetpub\wwwroot\documentation'

Mit diesen Skriptdateien und der documentation.zip-Datei, die sich in Ihrem Anwendungspaket befinden, wird bei der Bereitstellung zunächst die ASP.NET-Anwendung erzeugt und dann die Website der Dokumentation bereitgestellt.

Im vorliegende Beispiel wird eine einfache statische Website bereitgestellt, jedoch mit einer benutzerdefinierten Anwendungsbereitstellung, die Sie für jede Art von Anwendung einsetzen können und bei der Sie Elastic Beanstalk die Verwaltung derAWSRessourcen dafür.