Schnellstart: Bereitstellen in Azure-Container-Apps mit IntelliJ IDEA
In diesem Artikel wird erläutert, wie Sie eine containerisierte Anwendung in Azure-Container-Apps mithilfe des Azure Toolkits für IntelliJ IDEA bereitstellen. Der Artikel verwendet einen Beispiel-Back-End-Web-API-Dienst, der eine statische Sammlung von Musikalben zurückgibt.
Voraussetzungen
- Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie kein Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
- 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.
- Maven 3.5.0 oder höher
- Einen Docker-Client
- 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.
Klonen des Projekts
Verwenden Sie die folgenden Befehle, um die Beispiel-App zu klonen und die
IDE
Verzweigung auszuchecken:git clone https://github.com/Azure-Samples/containerapps-albumapi-java cd containerapps-albumapi-java git checkout IDE
Wählen Sie " Öffnen" aus, um das Projekt in IntelliJ IDEA zu öffnen.
Erstellen und lokales Ausführen des Projekts
Verwenden Sie den folgenden Befehl, um das Projekt mit Maven zu erstellen:
mvn clean package -DskipTests
Um zu überprüfen, ob die Anwendung ausgeführt wird, öffnen Sie einen Browser, und wechseln Sie zu
http://localhost:8080/albums
. Die Seite gibt eine Liste von JSON-Objekten zurück, die der Ausgabe des folgenden Befehls ähneln:java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
Pushimage in eine Azure-Containerregistrierung
Um Ihr Projekt in Azure-Container-Apps bereitzustellen, müssen Sie das Containerimage erstellen und zuerst in eine Azure-Containerregistrierung übertragen.
Erweitern Sie in der Azure-Explorer-Ansicht den Azure-Knoten, klicken Sie mit der rechten Maustaste auf "Containerregistries", und wählen Sie dann "In Azure Portal erstellen" aus.
Geben Sie auf der Seite "Containerregistrierung erstellen" die folgenden Informationen ein:
- Abonnement: Gibt das Azure-Abonnement an, das Sie für Ihre 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.
- Use Existing: Specifies that you must select from a list of resource groups that are associated with your Azure account.
- Registrierungsname: Gibt einen Namen für die neue Containerregistrierung an.
- Speicherort: 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.
Wählen Sie "Überprüfen" aus, und vergewissern Sie sich, dass die Informationen korrekt sind. Wählen Sie anschließend Erstellen.
Navigieren Sie auf der Registerkarte "Projekt " zu Ihrem Projekt, und öffnen Sie Dockerfile.
Wählen Sie das Azure-Symbol und dann "Pushimage" in die Azure-Containerregistrierung aus.
Wählen Sie die Registrierung aus, die Sie im vorherigen Schritt erstellt haben, geben Sie die folgenden Informationen ein, und wählen Sie dann "Ausführen" aus.
- Repositoryname: Gibt den Namen für das Repository an.
- Tagname: Gibt die Version eines Bilds oder eines anderen Artefakts an.
Erstellen einer Umgebung und einer Container-App
Führen Sie die folgenden Schritte aus, um Ihre Umgebung einzurichten und eine Container-App in Azure bereitzustellen:
Klicken Sie in der Azure Explorer-Ansicht mit der rechten Maustaste auf Container-Apps-Umgebung, und wählen Sie dann "Container-Apps-Umgebung erstellen" aus.
Geben Sie auf der Seite "Container-Apps-Umgebung erstellen" die folgenden Informationen ein, und wählen Sie dann "OK" aus.
- Abonnement: Gibt das Azure-Abonnement an, das Sie verwenden möchten.
- Ressourcengruppe: Gibt die Ressourcengruppe für Ihre Container-Apps an. Wählen Sie eine der folgenden Optionen aus:
- Create New: Gibt an, dass Sie eine neue Ressourcengruppe erstellen möchten.
- Use Existing: Specifies that you must select from a list of resource groups that are associated with your Azure account.
- Name: Gibt den Namen für die neue Container-Apps-Umgebung an.
- Region: Gibt die entsprechende Region an (z . B. Ost-USA).
- Log Analytics-Arbeitsbereich: Gibt den Log Analytics-Arbeitsbereich an, den Sie verwenden oder akzeptieren möchten.
Klicken Sie mit der rechten Maustaste auf die container-Apps-Umgebung, die Sie erstellt haben, und wählen Sie ">Container-App erstellen" im Azure-Explorer aus. Geben Sie die folgenden Informationen ein:
- Abonnement: Gibt das Azure-Abonnement an, das Sie verwenden möchten.
- Ressourcengruppe: Gibt die Ressourcengruppe für Ihre Container-Apps an. Wählen Sie eine der folgenden Optionen aus:
- Create New: Gibt an, dass Sie eine neue Ressourcengruppe erstellen möchten.
- Use Existing: Specifies that you must select from a list of resource groups that are associated with your Azure account.
- Name: Gibt den Namen für eine neue Container-App an.
- Region: Gibt die entsprechende Region an (z . B. Ost-USA).
- Umgebung: Gibt die Container-Apps-Umgebung an, die Sie verwenden möchten.
- Schnellstart: Wählen Sie "Schnellstartbild verwenden" aus.
Wählen Sie OK aus. Das Toolkit zeigt eine Statusmeldung an, wenn die App-Erstellung erfolgreich ist.
Bereitstellen der Container-App
Navigieren Sie auf der Registerkarte "Projekt " zu Ihrem Projekt, und öffnen Sie Dockerfile.
Wählen Sie das Azure-Symbol und dann " Image in Container-App bereitstellen" aus.
Geben Sie auf der Seite "Image für Azure Container Apps bereitstellen" die folgenden Informationen ein, und wählen Sie dann "Ausführen" aus.
- Dockerfile/Image: Gibt den Pfad der Dockerfile-Datei an oder akzeptiert den Standardwert.
- Containerregistrierung: Gibt die Containerregistrierung an, die Sie verwenden möchten.
- Repositoryname: Gibt den Repositorynamen an, den Sie unter Ihrer Containerregistrierung verwenden möchten.
- Tagname: Gibt den Tagnamen an, den Sie unter Ihrer Containerregistrierung verwenden möchten.
- Container-App: Gibt die Container-App an, für die Sie bereitstellen möchten.
- Ingress: Aktivieren Des Eingangs für Anwendungen, die einen HTTP- oder TCP-Endpunkt erfordern. Wählen Sie Aktivieren.
- Externer Datenverkehr: Aktivieren Sie externen Datenverkehr für Anwendungen, die einen HTTP- oder TCP-Endpunkt benötigen. Wählen Sie Aktivieren.
- Zielport: Legen Sie diesen Wert auf die von Ihrem Container verwendete Portnummer fest. Öffnen Sie port 8080 in diesem Schritt.
Nach Abschluss der Bereitstellung zeigt das Azure Toolkit für IntelliJ eine Benachrichtigung an. Wählen Sie Durchsuchen aus, um die bereitgestellte App in einem Browser zu öffnen.
Fügen Sie in der Adressleiste des Browsers den /albums
Pfad zum Ende der App-URL an, um Daten aus einer Beispiel-API-Anforderung anzuzeigen.
Bereinigen von Ressourcen
Wenn Sie eine Azure-Container-Apps-Ressource sauber und entfernen möchten, können Sie die Ressource oder Ressourcengruppe löschen. Wenn Sie die Ressourcengruppe löschen, werden auch alle anderen Ressourcen gelöscht, die ihr zugeordnet sind. Führen Sie die folgenden Schritte aus, um Ressourcen zu sauber:
Um Ihre Azure Container Apps-Ressourcen zu löschen, navigieren Sie zur linken Azure Explorer-Randleiste, und suchen Sie das Container-Apps-Umgebungselement.
Klicken Sie mit der rechten Maustaste auf den Azure-Container-Apps-Dienst, den Sie löschen möchten, und wählen Sie dann "Löschen" aus.
Um Ihre Ressourcengruppe zu löschen, besuchen Sie die Azure-Portal, und löschen Sie die Ressourcen unter Ihrem Abonnement manuell.