Wdrażanie usługi roboczej na Azure

Aby utworzyć nowy projekt usługi roboczej za pomocą programu Visual Studio, wybierz pozycję Plik>nowy>projekt.... W oknie dialogowym Tworzenie nowego projektu wyszukaj frazę "Usługa procesu roboczego" i wybierz szablon Usługa procesu roboczego. Wprowadź żądaną nazwę projektu, wybierz odpowiednią lokalizację, a następnie wybierz pozycję Dalej. Na stronie Dodatkowe informacje w polu Platforma docelowa wybierz pozycję .NET 5.0, a następnie zaznacz opcję Włącz platformę Docker, aby włączyć obsługę platformy Docker . Wybierz żądany system operacyjny Platformy Docker.

Aby utworzyć nowy projekt usługi roboczej za pomocą programu Visual Studio Code, możesz uruchomić polecenia interfejsu wiersza polecenia platformy .NET z poziomu zintegrowanego terminalu. Aby uzyskać więcej informacji, zobacz Visual Studio Code: Zintegrowany terminal.

Otwórz zintegrowany terminal, uruchom polecenie dotnet new i zastąp <Project.Name> odpowiednią nazwą projektu.

dotnet new worker --name <Project.Name>

Aby uzyskać więcej informacji na temat polecenia nowego projektu usługi roboczej w CLI platformy .NET, zobacz dotnet new worker.

Aby utworzyć nowy projekt usługi Roboczej przy użyciu interfejsu wiersza polecenia platformy .NET, otwórz swój ulubiony terminal w katalogu roboczym. dotnet new Uruchom polecenie i zastąp element <Project.Name> odpowiednią nazwą projektu.

dotnet new worker --name <Project.Name>

Aby uzyskać więcej informacji na temat polecenia dla nowego projektu usługi roboczej w .NET CLI, zobacz dotnet new worker.

Aby skompilować aplikację z poziomu programu Visual Studio, wybierz pozycję F6 lub wybierz opcję menu Kompiluj>rozwiązanie kompilacji .

Aby skompilować aplikację z poziomu programu Visual Studio Code, otwórz zintegrowane okno terminalu i uruchom dotnet build polecenie z katalogu roboczego.

dotnet build

Aby uzyskać więcej informacji na temat polecenia kompilacji .NET CLI, zobacz dotnet build.

Aby skompilować aplikację z poziomu interfejsu wiersza polecenia platformy .NET, uruchom dotnet build polecenie z katalogu roboczego.

dotnet build <path/to/project.csproj>

Określ wartość <path/to/project.csproj> , która jest ścieżką do pliku projektu do skompilowania. Aby uzyskać więcej informacji na temat polecenia kompilacji interfejsu wiersza polecenia platformy .NET, zobacz dotnet build.

Jeśli podczas tworzenia nowego projektu Worker wybrano poprawnie pole wyboru Włącz platformę Docker , przejdź do kroku Kompilowanie obrazu platformy Docker .

Jeśli ta opcja nie została wybrana, nie martw się — możesz ją dodać teraz. W programie Visual Studio kliknij prawym przyciskiem myszy węzeł projektu w Eksploratorze rozwiązań i wybierz pozycję Dodaj>obsługę platformy Docker. Zostanie wyświetlony monit o wybranie docelowego systemu operacyjnego; wybierz przycisk OK z domyślnym wyborem systemu operacyjnego.

W programie Visual Studio Code potrzebne jest rozszerzenie platformy Docker i rozszerzenie konta platformy Azure . Otwórz paletę poleceń i wybierz opcję Docker: Dodaj pliki platformy Docker do obszaru roboczego . Jeśli zostanie wyświetlony monit o wybranie platformy aplikacji, wybierz pozycję .NET: Konsola Core. Jeśli zostanie wyświetlony monit o wybranie projektu, wybierz utworzony projekt Usługi roboczej. Po wyświetleniu monitu o wybór systemu operacyjnego wybierz pierwszy na liście system operacyjny. Po wyświetleniu monitu o dołączenie opcjonalnych plików narzędzia Docker Compose wybierz pozycję Nie.

Używając interfejsu wiersza polecenia, plik Dockerfilenie jest tworzony. Skopiuj jego zawartość do nowego pliku o nazwie Dockerfile w katalogu głównym projektu.

Aby uzyskać więcej informacji na temat oficjalnych obrazów platformy .NET, zobacz Docker Hub: .NET Runtime i Docker Hub: .NET SDK.

Kliknij prawym przyciskiem myszy plik Dockerfile w Eksploratorze rozwiązań, a następnie wybierz polecenie Kompiluj obraz platformy Docker. Zostanie wyświetlone okno Dane wyjściowe z raportem o postępie docker build polecenia.

Kliknij prawym przyciskiem myszy plik Dockerfile w Eksploratorze, a następnie wybierz pozycję Kompiluj obraz. Po wyświetleniu monitu o oznaczenie obrazu jako wprowadź appcloudservice:latest. Terminal danych wyjściowych Docker Task wyświetla informacje o postępie polecenia Docker build.

{
  "type": "docker-build",
  "label": "docker-build: release",
  "dependsOn": [
    "build"
  ],
  "dockerBuild": {
    "tag": "appcloudservice:latest",
    "dockerfile": "${workspaceFolder}/cloud-service/Dockerfile",
    "context": "${workspaceFolder}",
    "pull": true
  },
  "netCore": {
    "appProject": "${workspaceFolder}/cloud-service/App.CloudService.csproj"
  }
}

Otwórz okno terminalu w katalogu głównym pliku Dockerfile i uruchom następujące polecenie platformy Docker:

docker build -t appcloudservice:latest -f Dockerfile .

Zasób usługi Azure Container Registry (ACR) umożliwia tworzenie i przechowywanie obrazów kontenerów oraz artefaktów oraz zarządzanie nimi w rejestrze prywatnym. Aby utworzyć rejestr kontenerów, musisz utworzyć nowy zasób w witrynie Azure Portal.

1. Wybierz subskrypcję i odpowiednią grupę zasobów (lub utwórz nową).
2. Wprowadź nazwę rejestru.
3. Wybierz lokalizację.
4. Wybierz odpowiednią jednostkę SKU, na przykład Podstawowa.
5. Wybierz opcję Recenzja i utwórz.
6. Po zakończeniu sprawdzania poprawności wybierz pozycję Utwórz.

Zasób usługi Azure Container Registry (ACR) umożliwia tworzenie i przechowywanie obrazów kontenerów oraz artefaktów oraz zarządzanie nimi w rejestrze prywatnym. Otwórz okno terminalu w katalogu głównym pliku Dockerfile i uruchom następujące polecenie Azure CLI.

az login

az account set --subscription <subscription name or id>

Po zalogowaniu się do Azure CLI, sesja może wchodzić w interakcje z zasobami zgodnie z uprawnieniami.

Jeśli nie masz jeszcze grupy zasobów, z którą chcesz skojarzyć usługę procesu roboczego, utwórz ją przy użyciu polecenia az group create.

az group create -n <resource group> -l <location>

<resource group> Podaj nazwę, oraz <location>. Aby utworzyć rejestr kontenerów, wywołaj az acr create polecenie .

az acr create -n <registry name> -g <resource group> --sku <sku> --admin-enabled true

Zastąp symbole zastępcze własnymi odpowiednimi wartościami:

• <registry name>: nazwa rejestru.
• <resource group>: użyta nazwa grupy zasobów.
• <sku>: akceptowane wartości, Podstawowa, Klasyczna, Premium lub Standardowa.

Poprzednie polecenie:

• Tworzy rejestr kontenerów Azure Container Registry, podając nazwę rejestru, w określonej grupie zasobów.
• Włączono użytkownika administratora — jest to wymagane w przypadku usługi Azure Container Instances.

Kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań, a następnie wybierz pozycję Publikuj. Zostanie wyświetlone okno dialogowe Publikowanie . W polu Cel wybierz pozycję Azure , a następnie pozycję Dalej.

W polu Określony element docelowy wybierz pozycję Azure Container Registry , a następnie pozycję Dalej.

Następnie w polu Container Registry wybierz nazwę subskrypcji użytą do utworzenia zasobu usługi ACR. W obszarze wyboru Rejestry kontenerów wybierz utworzony rejestr kontenerów, a następnie wybierz pozycję Zakończ.

Spowoduje to utworzenie profilu publikowania, który może służyć do publikowania obrazu w rejestrze kontenerów. Wybierz przycisk Publikuj, aby wypchnąć obraz do rejestru kontenerów, okno Dane wyjściowe raportuje postęp publikacji – a gdy proces zakończy się pomyślnie, zobaczysz komunikat "Pomyślnie opublikowany".

Wybierz pozycję Docker na pasku działań w programie Visual Studio Code. Rozwiń panel drzewa widoku IMAGES, następnie rozwiń węzeł obrazu appcloudservice i kliknij prawym przyciskiem myszy na tagu latest.

Zintegrowane okno terminalu docker push zgłasza postęp polecenia w rejestrze kontenerów.

Aby wypchnąć obraz do rejestru kontenerów, musisz najpierw zalogować się do rejestru:

az acr login -n <registry name>

Polecenie az acr login loguje się do rejestru kontenerów za pomocą interfejsu wiersza polecenia platformy Docker. Aby wypchnąć obraz do rejestru kontenerów, użyj polecenia az acr build z nazwą rejestru kontenerów jako :<registry name>

az acr build -r <registry name> -t appcloudservice .

Poprzednie polecenie:

• Pakuje źródło do pliku tar .
• Przekazuje go do rejestru kontenerów.
• Rejestr kontenerów rozpakuje plik tar .
• Uruchamia polecenie docker build w zasobie rejestru kontenerów względem pliku Dockerfile.
• Dodaje obraz do rejestru kontenerów.

W programie Visual Studio Code wybierz pozycję Docker na pasku działań. Rozwiń węzeł REJESTRY , a następnie wybierz pozycję Połącz rejestr. Po wyświetleniu monitu wybierz pozycję Azure i w razie potrzeby zaloguj się.

Rozwiń węzeł REJESTRY, wybierz Azure, swoją subskrypcję >, rejestr kontenerów, obraz, a następnie kliknij prawym przyciskiem myszy tag. Wybierz opcję Wdrażanie obrazu do Azure Container Instances.

Aby utworzyć wystąpienie kontenera, najpierw utwórz grupę kontenerów az container create przy użyciu polecenia .

az container create -g <resource group> \
  --name <instance name> \
  --image <registry name>.azurecr.io/<image name>:latest \
  --registry-password <password>

Podaj odpowiednie wartości:

• <resource group>: nazwa grupy zasobów, której używasz w tym samouczku.
• <instance name>: nazwa wystąpienia kontenera.
• <registry name>: nazwa rejestru kontenerów.
• <image name>: nazwa obrazu.
• <password>: hasło do rejestru kontenerów — można je pobrać z witryny Azure Portal, > zasobów usługi Container Registry.

Aby utworzyć instancję kontenera, należy również utworzyć nowy zasób w portalu Azure.

1. Wybierz tę samą subskrypcję i odpowiednią grupę zasobów z poprzedniej sekcji.
2. Wprowadź nazwę kontenera —appcloudservice-container .
3. Wybierz region odpowiadający poprzedniemu zaznaczeniu Lokalizacja .
4. W polu Źródło obrazu wybierz pozycję Azure Container Registry.
5. Wybierz Rejestr według nazwy podanej w poprzednim kroku.
6. Wybierz Obraz i tag Obraz.
7. Wybierz opcję Recenzja i utwórz.
8. Jeśli weryfikacja zakończyła się powodzeniem, wybierz Utwórz.

Utworzenie zasobów może potrwać chwilę. Po ich utworzeniu wybierz przycisk Przejdź do zasobu.

Aby uzyskać więcej informacji, zobacz Szybki Start: Tworzenie wystąpienia kontenera Azure.

Aby sprawdzić, czy usługa procesu roboczego działa prawidłowo, możesz wyświetlić dzienniki z uruchomionej aplikacji. Użyj polecenia az container logs:

az container logs -g <resource group> --name <instance name>

Podaj odpowiednie wartości:

• <resource group>: nazwa grupy zasobów, której używasz w tym samouczku.
• <instance name>: nazwa wystąpienia kontenera.

Zobaczysz dzienniki wyjściowe usługi roboczej platformy .NET, co oznacza, że aplikacja konteneryzowana została pomyślnie wdrożona na ACI.