Bereitstellen einer Java-App in Azure-Web-Apps für Container mithilfe des Azure-Toolkits für IntelliJ

Docker-Container sind eine weit verbreitete Methode zum Bereitstellen von Webanwendungen. Mithilfe von Docker-Containern können Entwickler ihre Projektdateien und Abhängigkeiten für die Bereitstellung auf einem Server in einem einzelnen Paket zusammenfassen. Mit dem Azure-Toolkit für IntelliJ wird dieser Prozess für Java-Entwickler vereinfacht, indem Features für die Bereitstellung von Containern in Microsoft Azure hinzugefügt werden.

In diesem Artikel werden die Schritte zum Erstellen einer einfachen „Hello World“-Web-App beschrieben. Außerdem erfahren Sie, wie Sie Ihre Web-App mithilfe des Azure-Toolkits für IntelliJ in einem Linux-Container in Azure veröffentlichen.

Voraussetzungen

• Ein unterstütztes Java Development Kit (JDK). Weitere Informationen zu den JDKs, die für die Entwicklung in Azure verfügbar sind, finden Sie im Artikel zur Java-Unterstützung in Azure und Azure Stack.
• IntelliJ IDEA, Ultimate oder Community Edition.
• Das Azure-Toolkit für IntelliJ. Weitere Informationen finden Sie unter Installieren des Azure-Toolkits für IntelliJ. Sie müssen sich auch bei Ihrem Azure-Konto für das Azure-Toolkit für IntelliJ anmelden. Weitere Informationen finden Sie in den Anmeldeanweisungen für das Azure Toolkit für IntelliJ.

• Einen Docker-Client

Hinweis

Sie müssen für die Schritte in diesem Tutorial Docker so konfigurieren, dass der Daemon ohne TLS an Port 2375 verfügbar gemacht wird. Sie können diese Einstellung beim Installieren von Docker oder über das Docker-Einstellungsmenü konfigurieren.

Installation und Anmeldung

Im Folgenden wird Schritt für Schritt beschrieben, wie Sie den Azure-Anmeldeprozess in Ihrer IntelliJ-Entwicklungsumgebung durchführen.

1. Falls Sie das Plug-In nicht installiert haben, helfen Ihnen die Informationen unter Installieren des Azure-Toolkits für IntelliJ weiter.

2. Navigieren Sie zum Anmelden bei Ihrem Azure-Konto zur linken Seitenleiste des Azure-Explorers, und klicken Sie anschließend auf das Symbol Azure-Anmeldung. Alternativ können Sie auch unter Extras die Option Azure erweitern und auf Azure-Anmeldung klicken.

   

3. Wählen Sie im Fenster für die Azure-Anmeldung die Option Device Login (Geräteanmeldung) aus, und klicken Sie anschließend auf Sign in (Anmelden). Weitere Anmeldeoptionen finden Sie hier.

4. Klicken Sie im Dialogfeld Azure Device Login (Azure-Geräteanmeldung) auf Copy&Open (Kopieren und öffnen).

5. Fügen Sie im Browser Ihren Gerätecode ein, den Sie im vorherigen Schritt durch Klicken auf Copy&Open (Kopieren und öffnen) kopiert haben, und klicken Sie anschließend auf Next (Weiter).

6. Wählen Sie Ihr Azure-Konto aus, und führen Sie alle erforderlichen Authentifizierungsschritte aus, um sich anzumelden.

7. Schließen Sie nach der Anmeldung den Browser, und wechseln Sie zurück zur IntelliJ-IDE. Wählen Sie im Dialogfeld Abonnements auswählen die Abonnements aus, die Sie verwenden möchten, und klicken Sie dann auf Auswählen.

Erstellen eines neuen Web-App-Projekts

1. Klicken Sie auf Datei, erweitern Sie die Option Neu, und klicken Sie anschließend auf Projekt.

2. Wählen Sie im Dialogfeld Neues Projekt die Option Maven aus, und vergewissern Sie sich, dass die Option Aus Archetyp erstellen aktiviert ist. Wählen Sie in der Liste den Eintrag maven-archetype-webapp aus, und klicken Sie anschließend auf Weiter.

   

3. Erweitern Sie das Dropdownmenü Artifact Coordinates (Artefaktkoordinaten), um alle Eingabefelder anzuzeigen, und geben Sie die unten aufgeführten Informationen für Ihre neue Web-App an. Klicken Sie anschließend auf Weiter:

   • Name: Der Name Ihrer Web-App. Wird automatisch in das Feld ArtifactId der App eingefügt.
   • GroupId: Der Name der Artefaktgruppe, in der Regel ein Unternehmen Standard. (Beispiel: com.microsoft.azure.)
   • Version: Wir behalten die Standardversion 1.0-SNAPSHOT bei.

4. Passen Sie alle gewünschten Maven-Einstellungen an, oder übernehmen Sie die Standardeinstellungen, und klicken Sie dann auf Fertig stellen.

5. Navigieren Sie links auf der Registerkarte Projekt zu Ihrem Projekt, und öffnen Sie die Datei src/main/webapp/index.jsp. Ersetzen Sie den Code durch Folgendes, und speichern Sie die Änderungen:

   <html>
    <body>
      <b><% out.println("Hello World!"); %></b>
    </body>
   </html>
   

   

Erstellen einer Azure-Containerregistrierung, die als private Docker-Registrierung verwendet werden soll

Die folgende Anleitung führt Sie durch die Verwendung des Azure-Portals zur Erstellung einer Azure-Containerregistrierung.

Hinweis

Wenn Sie statt des Azure-Portals die Azure CLI verwenden möchten, führen Sie die Schritte unter Erstellen einer privaten Docker-Containerregistrierung mit der Azure CLI 2.0 aus.

1. Navigieren Sie zum Azure-Portal, und melden Sie sich an.

   Nachdem Sie sich im Azure-Portal bei Ihrem Konto angemeldet haben, können Sie die Schritte im Artikel Erstellen einer privaten Docker-Containerregistrierung im Azure-Portal ausführen, die im Folgenden aus Gründen der Zweckmäßigkeit umschrieben werden.

2. Klicken Sie auf das Menüsymbol für + Ressource erstellen, die Kategorie Container und dann auf Containerregistrierung.

3. Geben Sie die folgenden Informationen ein, wenn die Seite Containerregistrierung erstellen angezeigt wird:

   • Abonnement: Gibt das Azure-Abonnement an, das Sie für die neue Containerregistrierung verwenden möchten.

   • Ressourcengruppe: Gibt die Ressourcengruppe für Ihre Containerregistrierung an. Wählen Sie eine der folgenden Optionen aus:

     • Create New: Gibt an, dass Sie eine neue Ressourcengruppe erstellen möchten.
     • Vorhandene verwenden: Geben Sie an, dass Sie in einer Liste von Ressourcengruppen, die Ihrem Azure-Konto zugeordnet sind, eine Auswahl treffen möchten.

   • Registrierungsname: Gibt den Namen für die neue Containerregistrierung an.

   • Ort: Gibt die Region an, in der Ihre Containerregistrierung erstellt wird (z. B. "West US").

   • SKU: Gibt die Dienstebene für Ihre Containerregistrierung an. Wählen Sie für dieses Tutorial die Option Basic aus. Weitere Informationen finden Sie unter Azure Container Registry-Tarife.

4. Klicken Sie auf Bewerten + erstellen, und überprüfen Sie, ob die Informationen korrekt sind. Klicken Sie abschließend auf Erstellen.

Bereitstellen Ihrer Web-App in einem Docker-Container

Mit den folgenden Schritten wird die Konfiguration der Docker-Unterstützung für Ihre Web-App und die Bereitstellung der Web-App in einem Docker-Container beschrieben.

1. Navigieren Sie auf der linken Registerkarte Projekt zu Ihrem Projekt, und klicken Sie mit der rechten Maustaste darauf. Erweitern Sie Azure, und klicken Sie auf Add Docker Support (Docker-Unterstützung hinzufügen).

   Damit wird automatisch eine Docker-Datei mit einer Standardkonfiguration erstellt.

   

2. Nachdem Sie die Docker-Unterstützung hinzugefügt haben, können Sie wie folgt vorgehen: Klicken Sie im Projekt-Explorer mit der rechten Maustaste auf Ihr Projekt, erweitern Sie die Option Azure, und klicken Sie dann auf Run on Web App for Containers (In Web-App für Container ausführen).

3. Geben Sie im Dialogfeld Run on Web App for Containers (In Web-App für Container ausführen) die folgenden Informationen ein:

   • Name: gibt den Anzeigenamen im Azure-Toolkit an.

   • Containerregistrierung: Wählen Sie die Containerregistrierung aus dem Dropdownmenü aus, das Sie im vorherigen Abschnitt dieses Artikels erstellt haben. Die Felder für Server-URL, Benutzername und Kennwort werden automatisch ausgefüllt.

   • Image und Tag: gibt den Namen des Containerimages an; dabei wird in der Regel die folgende Syntax verwendet: „Registrierung.azurecr.io/App-Name:latest“; dabei gilt Folgendes:

     • Registrierung ist Ihre Containerregistrierung aus dem vorherigen Abschnitt dieses Artikels.
     • App-Name ist der Name Ihrer Web-App.

   • Use Existing Web App (Vorhandene Web-App verwenden) oder Create New Web App (Neue Web-App erstellen): gibt an, ob Sie den Container in einer vorhandenen Web-App bereitstellen oder eine neue Web-App erstellen. Mit dem von Ihnen angegebenen App-Namen wird die URL für Ihre Web-App erstellt, z. B. wingtiptoys.azurewebsites.net.

   • Ressourcengruppe: gibt an, ob Sie eine vorhandene Ressourcengruppe verwenden oder eine neue erstellen möchten.

   • App Service Plan: Gibt an, ob Sie einen vorhandenen oder neuen App-Serviceplan erstellen möchten.

4. Wenn Sie mit dem Konfigurieren der oben aufgeführten Einstellungen fertig sind, klicken Sie auf Ausführen. Nachdem Ihre Web-App erfolgreich bereitgestellt wurde, wird der Status im Fenster Ausführen angezeigt.

5. Nach der Veröffentlichung Ihrer Web-App können Sie zu der URL navigieren, die für Ihre Web-App zuvor angegeben wurde, z. B. wingtiptoys.azurewebsites.net.

   

Optional: Ändern der Veröffentlichungseinstellungen ihrer Web-App

1. Nachdem Sie Ihre Web-App veröffentlicht haben, werden die Einstellungen als Standard gespeichert. Sie können Ihre Anwendung in Azure ausführen, indem Sie auf der Symbolleiste auf den grünen Pfeil klicken. Sie können diese Einstellungen ändern, indem Sie auf das Dropdownmenü für Ihre Web-App und dann auf Konfigurationen bearbeiten klicken.

   

2. Wenn das Dialogfeld für die Ausführungs-/Debugkonfigurationen angezeigt wird, können Sie beliebige Standardeinstellungen ändern. Klicken Sie anschließend auf OK.

Nächste Schritte

Zusätzliche Ressourcen für Docker finden Sie auf der offiziellen Docker-Website.

Um Fehler zu melden oder neue Features anzufordern, erstellen Sie Probleme in unserem GitHub-Repository, oder stellen Sie Fragen zu Stack Overflow mit tag azure-java-tools.

Weitere Informationen zur Verwendung von Java mit Azure finden Sie unter den folgenden Links:

• Azure für Java-Entwickler
• Working with Azure DevOps and Java (Arbeiten mit Azure DevOps und Java)
• Java-Unterstützung in Azure und Azure Stack