Szybki start: kompilowanie i wdrażanie z lokalnego kodu źródłowego do usługi Azure Container Apps
W tym artykule pokazano, jak utworzyć i wdrożyć mikrousługę w usłudze Azure Container Apps z lokalnego kodu źródłowego przy użyciu wybranego języka programowania. W tym przewodniku Szybki start utworzysz usługę internetowego interfejsu API zaplecza, która zwraca statyczną kolekcję albumów muzycznych.
Poniższy zrzut ekranu przedstawia dane wyjściowe wdrożonej usługi interfejsu API albumu.
Wymagania wstępne
Do ukończenia tego projektu potrzebne są następujące elementy:
| 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 . |
| Usługa Git | Zainstalowanie oprogramowania Git. |
| Interfejs wiersza polecenia platformy Azure | Zainstaluj interfejs wiersza polecenia platformy Azure. |
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.
az extension add --name containerapp --upgrade --allow-preview true
Po zainstalowaniu bieżącego rozszerzenia zarejestruj Microsoft.App 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 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.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
Pobieranie przykładowego kodu
Uruchom następujące polecenie, aby sklonować przykładową aplikację w wybranym języku i przejść do folderu źródłowego projektu.
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
Kompilowanie i wdrażanie aplikacji kontenera
Najpierw uruchom następujące polecenie, aby utworzyć grupę zasobów, która będzie zawierać zasoby utworzone w tym przewodniku Szybki start.
az group create --name $RESOURCE_GROUP --location $LOCATION
Skompiluj i wdróż pierwszą aplikację kontenera za containerapp up pomocą polecenia . To polecenie spowoduje:
- Tworzenie grupy zasobów
- Tworzenie rejestru Azure Container Registry
- Skompiluj obraz kontenera i wypchnij go do rejestru
- Tworzenie środowiska usługi Container Apps za pomocą obszaru roboczego usługi Log Analytics
- Tworzenie i wdrażanie aplikacji kontenera przy użyciu wbudowanego obrazu kontenera
Polecenie up używa pliku Dockerfile w folderze projektu do skompilowania obrazu kontenera. Instrukcja EXPOSE w pliku Dockerfile definiuje port docelowy, który jest portem używanym do wysyłania ruchu przychodzącego do kontenera.
W poniższym przykładzie kodu (kropka . ) informuje containerapp up o uruchomieniu w bieżącym katalogu projektu, który zawiera również plik Dockerfile.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
Uwaga
Jeśli polecenie zwróci błąd z komunikatem "AADSTS50158: Wyzwanie zabezpieczeń zewnętrznych nie powiodło się", uruchom polecenie az login --scope https://graph.microsoft.com//.default , aby zalogować się przy użyciu wymaganych uprawnień, a następnie ponownie uruchom az containerapp up polecenie.
Weryfikowanie wdrożenia
Znajdź adres URL aplikacji kontenera w danych wyjściowych az containerapp up polecenia . Przejdź do adresu URL w przeglądarce. Dodaj /albums na końcu adresu URL, aby wyświetlić odpowiedź z interfejsu API.
Limity
Maksymalny rozmiar przekazywania kodu źródłowego to 200 MB. Jeśli przekazywanie przekroczy limit, zwracany jest błąd 413.
Czyszczenie zasobów
Jeśli nie zamierzasz kontynuować pracy z samouczkiem Wdrażanie frontonu , możesz usunąć zasoby platformy Azure utworzone podczas tego przewodnika Szybki start za pomocą następującego polecenia.
Uwaga
Następujące polecenie usuwa określoną grupę zasobów i wszystkie zawarte w niej zasoby. Jeśli grupa zawiera zasoby poza zakresem tego przewodnika Szybki start, zostaną również usunięte.
az group delete --name $RESOURCE_GROUP
Napiwek
Masz problemy? Poinformuj nas o usłudze GitHub, otwierając problem w repozytorium usługi Azure Container Apps.
Następne kroki
Po ukończeniu tego przewodnika Szybki start możesz przejść do sekcji Samouczek: komunikacja między mikrousługami w usłudze Azure Container Apps , aby dowiedzieć się, jak wdrożyć aplikację frontonu, która wywołuje interfejs API.