Szybki start: wdrażanie pliku artefaktu w usłudze Azure Container Apps (wersja zapoznawcza)
Z tego przewodnika Szybki start dowiesz się, jak wdrożyć aplikację kontenera ze wstępnie utworzonego pliku artefaktu. Przykład w tym artykule wdraża aplikację Java przy użyciu pliku JAR, który zawiera plik manifestu specyficzny dla języka Java. Twoim zadaniem jest utworzenie usługi internetowego interfejsu API zaplecza, która zwraca statyczną kolekcję albumów muzycznych. Po ukończeniu tego przewodnika Szybki start możesz kontynuować komunikację między mikrousługami , aby dowiedzieć się, jak wdrożyć aplikację frontonu, która wywołuje interfejs API.
Poniższy zrzut ekranu przedstawia dane wyjściowe wdrożonej usługi interfejsu API albumu.
Wymagania wstępne
| Wymaganie | Instrukcje |
|---|---|
| Konto platformy Azure | Jeśli go nie masz, utwórz bezpłatne konto. Aby kontynuować, musisz mieć uprawnienie Współautor lub Właściciel w subskrypcji platformy Azure. Aby uzyskać szczegółowe informacje, zobacz Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal . |
| Konto usługi GitHub | Pobierz go bezpłatnie. |
| git | Instalowanie narzędzia git |
| Interfejs wiersza polecenia platformy Azure | Zainstaluj interfejs wiersza polecenia platformy Azure. |
| Java | Zainstaluj zestaw JDK, zalecane 17 lub nowszy |
| Maven | Zainstaluj narzędzie Maven. |
Ustawienia
Aby zalogować się do platformy Azure z poziomu interfejsu wiersza polecenia, uruchom następujące polecenie i postępuj zgodnie z monitami, aby ukończyć proces uwierzytelniania.
az login
Aby upewnić się, że używasz najnowszej wersji interfejsu wiersza polecenia, uruchom polecenie uaktualniania.
az upgrade
Następnie zainstaluj lub zaktualizuj rozszerzenie usługi Azure Container Apps dla interfejsu wiersza polecenia.
Jeśli podczas uruchamiania az containerapp poleceń w interfejsie wiersza polecenia platformy Azure lub poleceniach cmdlet z modułu Az.App w programie Azure PowerShell wystąpią błędy dotyczące brakujących parametrów, upewnij się, że masz zainstalowaną najnowszą wersję rozszerzenia Azure Container Apps.
az extension add --name containerapp --upgrade
Uwaga
Począwszy od maja 2024 r., rozszerzenia interfejsu wiersza polecenia platformy Azure domyślnie nie włączają funkcji w wersji zapoznawczej. Aby uzyskać dostęp do funkcji usługi Container Apps w wersji zapoznawczej, zainstaluj rozszerzenie Container Apps za pomocą polecenia --allow-preview true.
az extension add --name containerapp --upgrade --allow-preview true
Teraz, po zainstalowaniu bieżącego rozszerzenia lub modułu Microsoft.App , zarejestruj przestrzenie nazw i Microsoft.OperationalInsights .
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Tworzenie zmiennych środowiskowych
Teraz, gdy konfiguracja interfejsu wiersza polecenia platformy Azure została ukończona, możesz zdefiniować zmienne środowiskowe używane w tym artykule.
Zdefiniuj następujące zmienne w powłoce powłoki bash.
RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>
W razie potrzeby możesz wykonać zapytanie dotyczące identyfikatora subskrypcji.
az account list --output table
Przygotowywanie repozytorium GitHub
Zacznij od sklonowania przykładowego repozytorium.
Użyj następującego polecenia git, aby sklonować przykładową aplikację do folderu code-to-cloud :
git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud
cd code-to-cloud
Tworzenie pliku JAR
Uwaga
Przykład języka Java obsługuje tylko kompilację narzędzia Maven, która powoduje utworzenie wykonywalnego pliku JAR. Kompilacja używa ustawień domyślnych, ponieważ przekazywanie zmiennych środowiskowych jest nieobsługiwane.
Skompiluj projekt za pomocą narzędzia Maven.
mvn clean package -DskipTests
Lokalne uruchamianie projektu
java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
Aby sprawdzić, czy aplikacja jest uruchomiona, otwórz przeglądarkę i przejdź do http://localhost:8080/albumswitryny . Strona zwraca listę obiektów JSON.
Wdrażanie artefaktu
Skompiluj i wdróż pierwszą aplikację kontenera z lokalnego pliku JAR za containerapp up pomocą polecenia .
To polecenie:
- Tworzy grupę zasobów
- Tworzy usługę Azure Container Registry
- Kompiluje obraz kontenera i wypycha go do rejestru
- Tworzy środowisko usługi Container Apps z obszarem roboczym usługi Log Analytics
- Tworzy i wdraża aplikację kontenera przy użyciu publicznego obrazu kontenera
Polecenie up używa pliku platformy Docker w katalogu głównym repozytorium, aby skompilować obraz kontenera. Instrukcja EXPOSE w pliku platformy Docker definiuje port docelowy. Jednak do utworzenia aplikacji kontenera nie jest wymagany plik platformy Docker.
Uwaga
Uwaga: w przypadku używania containerapp up w połączeniu z bazą kodu bez platformy Docker użyj parametru --location , aby aplikacja działa w lokalizacji innej niż Wschodnie stany USA.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
--ingress external \
--target-port 8080 \
--subscription $SUBSCRIPTION
Weryfikowanie wdrożenia
Skopiuj nazwę FQDN do przeglądarki internetowej. W przeglądarce internetowej przejdź do /albums punktu końcowego nazwy FQDN.
Wdrażanie pliku WAR
Możesz również wdrożyć aplikację kontenera z pliku WAR.
Czyszczenie zasobów
Jeśli nie zamierzasz nadal korzystać z tej aplikacji, możesz usunąć wystąpienie usługi Azure Container Apps i wszystkie skojarzone usługi, usuwając grupę zasobów.
Wykonaj następujące kroki, aby usunąć utworzone zasoby:
az group delete \
--resource-group $RESOURCE_GROUP
Napiwek
Masz problemy? Poinformuj nas o usłudze GitHub, otwierając problem w repozytorium usługi Azure Container Apps.