Szybki start: wdrażanie w usłudze Azure Container Apps przy użyciu środowiska IntelliJ IDEA

W tym artykule pokazano, jak wdrożyć konteneryzowaną aplikację w usłudze Azure Container Apps przy użyciu zestawu narzędzi Azure Toolkit for IntelliJ IDEA. W tym artykule użyto przykładowej usługi internetowego interfejsu API zaplecza, która zwraca statyczną kolekcję albumów muzycznych.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto .
• Obsługiwany zestaw Java Development Kit (JDK). Aby uzyskać więcej informacji na temat zestawów JDK dostępnych do użycia podczas tworzenia aplikacji na platformie Azure, zobacz Obsługa języka Java na platformie Azure i w usłudze Azure Stack.
• IntelliJ IDEA, Ultimate lub Community Edition.
• Maven 3.5.0+.
• Klient platformy Docker.
• Zestaw narzędzi Azure Toolkit for IntelliJ. Aby uzyskać więcej informacji, zobacz Instalowanie zestawu narzędzi Azure Toolkit for IntelliJ. Musisz również zalogować się do swojego konta platformy Azure dla zestawu narzędzi Azure Toolkit for IntelliJ. Aby uzyskać więcej informacji, zobacz Instrukcje logowania dla zestawu narzędzi Azure Toolkit for IntelliJ.

Klonowanie projektu

1. Użyj następujących poleceń, aby sklonować przykładową aplikację i wyewidencjonować IDE gałąź:

   git clone https://github.com/Azure-Samples/containerapps-albumapi-java
   cd containerapps-albumapi-java
   git checkout IDE
   

2. Wybierz pozycję Otwórz, aby otworzyć projekt w środowisku IntelliJ IDEA.

Kompilowanie i uruchamianie projektu lokalnie

1. Użyj następującego polecenia, aby skompilować projekt za pomocą narzędzia Maven:

   mvn clean package -DskipTests
   

2. Aby sprawdzić, czy aplikacja jest uruchomiona, otwórz przeglądarkę i przejdź do http://localhost:8080/albumsstrony . Strona zwraca listę obiektów JSON podobnych do danych wyjściowych następującego polecenia:

   java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
   

Wypychanie obrazu do usługi Azure Container Registry

Aby wdrożyć projekt w usłudze Azure Container Apps, musisz najpierw skompilować obraz kontenera i wypchnąć go do usługi Azure Container Registry.

1. W widoku Eksplorator platformy Azure rozwiń węzeł platformy Azure, kliknij prawym przyciskiem myszy pozycję Rejestry kontenerów, a następnie wybierz polecenie Utwórz w witrynie Azure Portal.

2. Na stronie Tworzenie rejestru kontenerów wprowadź następujące informacje:

   • Subskrypcja: określa subskrypcję platformy Azure, której chcesz użyć dla rejestru kontenerów.
   • Grupa zasobów: określa grupę zasobów dla rejestru kontenerów. Wybierz jedną z następujących opcji:
     • Utwórz nową: określa, że chcesz utworzyć nową grupę zasobów.
     • Użyj istniejącej: określa, że musisz wybrać z listy grup zasobów skojarzonych z kontem platformy Azure.
   • Nazwa rejestru: określa nazwę nowego rejestru kontenerów.
   • Lokalizacja: określa region, w którym jest tworzony rejestr kontenerów (na przykład Zachodnie stany USA).
   • Jednostka SKU: określa warstwę usługi dla rejestru kontenerów. Na potrzeby tego samouczka wybierz pozycję Podstawowa.

3. Wybierz pozycję Przejrzyj i utwórz i sprawdź, czy informacje są poprawne. Następnie wybierz przycisk Utwórz.

4. Na karcie Project (Projekt) przejdź do projektu i otwórz plik Dockerfile.

5. Wybierz ikonę platformy Azure, a następnie wybierz pozycję Wypychanie obrazu do usługi Azure Container Registry.

6. Wybierz rejestr utworzony w poprzednim kroku, wypełnij następujące informacje, a następnie wybierz pozycję Uruchom.

   • Nazwa repozytorium: określa nazwę repozytorium.
   • Nazwa tagu: określa wersję obrazu lub innego artefaktu.

   

Tworzenie środowiska i aplikacji kontenera

Wykonaj następujące kroki, aby skonfigurować środowisko i wdrożyć aplikację kontenera na platformie Azure:

1. Kliknij prawym przyciskiem myszy pozycję Środowisko aplikacji kontenera w widoku Eksplorator platformy Azure, a następnie wybierz pozycję Utwórz środowisko aplikacji kontenera.

2. Na stronie Tworzenie środowiska aplikacji kontenera wprowadź następujące informacje, a następnie wybierz przycisk OK.

   • Subskrypcja: określa subskrypcję platformy Azure, której chcesz użyć.
   • Grupa zasobów: określa grupę zasobów dla aplikacji kontenera. Wybierz jedną z następujących opcji:
     • Utwórz nową: określa, że chcesz utworzyć nową grupę zasobów.
     • Użyj istniejącej: określa, że musisz wybrać z listy grup zasobów skojarzonych z kontem platformy Azure.
   • Nazwa: określa nazwę nowego środowiska aplikacji kontenera.
   • Region: określa odpowiedni region (na przykład Wschodnie stany USA).
   • Obszar roboczy usługi Log Analytics: określa obszar roboczy usługi Log Analytics, którego chcesz użyć lub zaakceptować wartość domyślną.

   

3. Kliknij prawym przyciskiem myszy utworzone środowisko aplikacji kontenera i wybierz pozycję Utwórz>aplikację kontenera w eksploratorze platformy Azure. Wprowadź następujące informacje:

   • Subskrypcja: określa subskrypcję platformy Azure, której chcesz użyć.
   • Grupa zasobów: określa grupę zasobów dla aplikacji kontenera. Wybierz jedną z następujących opcji:
     • Utwórz nową: określa, że chcesz utworzyć nową grupę zasobów.
     • Użyj istniejącej: określa, że musisz wybrać z listy grup zasobów skojarzonych z kontem platformy Azure.
   • Nazwa: określa nazwę nowej aplikacji kontenera.
   • Region: określa odpowiedni region (na przykład Wschodnie stany USA).
   • Środowisko: określa środowisko usługi Container Apps, którego chcesz użyć.
   • Szybki start: wybierz pozycję Użyj obrazu Szybki start.

   

4. Wybierz przycisk OK. Zestaw narzędzi wyświetla komunikat o stanie po pomyślnym utworzeniu aplikacji.

Wdrażanie aplikacji kontenera

1. Na karcie Project (Projekt) przejdź do projektu i otwórz plik Dockerfile.

   

2. Wybierz ikonę platformy Azure, a następnie wybierz pozycję Wdróż obraz w aplikacji kontenera.

   

3. Na stronie Deploy Image to Azure Container Apps (Wdrażanie obrazu w usłudze Azure Container Apps) wprowadź następujące informacje, a następnie wybierz pozycję Uruchom.

   • Dockerfile/Image: określa ścieżkę pliku Dockerfile lub zaakceptuje wartość domyślną.
   • Container Registry: określa rejestr kontenerów, którego chcesz użyć.
   • Nazwa repozytorium: określa nazwę repozytorium, którego chcesz użyć w rejestrze kontenerów.
   • Nazwa tagu: określa nazwę tagu, której chcesz użyć w rejestrze kontenerów.
   • Aplikacja kontenera: określa aplikację kontenera, do której chcesz wdrożyć.
   • Ruch przychodzący: włącz ruch przychodzący dla aplikacji, które wymagają punktu końcowego HTTP lub TCP. Wybierz opcję Włącz.
   • Ruch zewnętrzny: włącz ruch zewnętrzny dla aplikacji, które potrzebują punktu końcowego HTTP lub TCP. Wybierz opcję Włącz.
   • Port docelowy: ustaw tę wartość na numer portu używany przez kontener. Otwórz port 8080 w tym kroku.

   

4. Po zakończeniu wdrażania w zestawie narzędzi Azure Toolkit for IntelliJ zostanie wyświetlone powiadomienie. Wybierz pozycję Przeglądaj , aby otworzyć wdrożona aplikacja w przeglądarce.

   

Na pasku adresu przeglądarki dołącz /albums ścieżkę na końcu adresu URL aplikacji, aby wyświetlić dane z przykładowego żądania interfejsu API.

Czyszczenie zasobów

Jeśli chcesz wyczyścić i usunąć zasób usługi Azure Container Apps, możesz usunąć zasób lub grupę zasobów. Usunięcie grupy zasobów powoduje również usunięcie wszelkich innych skojarzonych z nią zasobów. Aby wyczyścić zasoby, wykonaj następujące czynności:

1. Aby usunąć zasoby usługi Azure Container Apps, przejdź do lewego paska bocznego eksploratora platformy Azure i znajdź element Środowisko usługi Container Apps.

2. Kliknij prawym przyciskiem myszy usługę Azure Container Apps, którą chcesz usunąć, a następnie wybierz pozycję Usuń.

3. Aby usunąć grupę zasobów, odwiedź witrynę Azure Portal i ręcznie usuń zasoby w ramach subskrypcji.

Następne kroki

• Omówienie języka Java w usłudze Azure Container Apps