Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Konta i zasoby usługi Azure Batch można zarządzać przy użyciu interfejsu azure Command-Line (interfejs wiersza polecenia platformy Azure). Istnieją polecenia służące do tworzenia i aktualizowania zasobów usługi Batch, takich jak pule, zadania i zadania podrzędne. Można również tworzyć skrypty dla wielu tych samych zadań wykonywanych za pomocą interfejsów API usługi Batch, poleceń cmdlet programu PowerShell i witryny Azure Portal.
Można uruchomić Azure CLI w usłudze Azure Cloud Shell lub zainstalować je lokalnie. Wersje są dostępne dla systemów operacyjnych Windows, Mac i Linux.
W tym artykule wyjaśniono, jak używać interfejsu wiersza polecenia platformy Azure z kontami i zasobami usługi Batch.
Konfiguracja Azure CLI
Wybierz sposób konfigurowania interfejsu wiersza polecenia platformy Azure:
- Uruchom Azure CLI w usłudze Cloud Shell.
- Zainstaluj interfejs wiersza polecenia platformy Azure lokalnie.
Jeśli dopiero zaczynasz korzystać z interfejsu wiersza polecenia platformy Azure, zobacz Wprowadzenie do interfejsu wiersza polecenia platformy Azure przed kontynuowaniem.
Jeśli wcześniej zainstalowano interfejs wiersza polecenia platformy Azure lokalnie, pamiętaj, aby zaktualizować instalację do najnowszej wersji.
Uwierzytelnianie za pomocą interfejsu wiersza polecenia platformy Azure
Aby użyć interfejsu wiersza polecenia platformy Azure z usługą Batch, najpierw zaloguj się do konta platformy Azure, a następnie zaloguj się do konta usługi Batch.
Zaloguj się do konta platformy Azure
Aby użyć interfejsu wiersza polecenia platformy Azure, najpierw zaloguj się do konta platformy Azure. Ten krok zapewnia dostęp do poleceń usługi Azure Resource Manager, które obejmują polecenia usługi Batch Management . Następnie można uruchamiać polecenia do zarządzania kontami Batch, kluczami, pakietami aplikacji i limitami przydziału.
Można uwierzytelnić konto platformy Azure w Azure CLI na dwa sposoby. Aby samodzielnie uruchomić polecenia, zaloguj się interaktywnie do interfejsu wiersza polecenia platformy Azure. Interfejs wiersza polecenia platformy Azure zapamiętuje poświadczenia i może użyć tych samych poświadczeń, aby zalogować cię do konta usługi Batch ponownie. Aby uruchomić polecenia ze skryptu lub aplikacji, uwierzytelnij się w Azure CLI za pomocą konta jednostki usługowej.
Aby interaktywnie zalogować się do interfejsu wiersza polecenia platformy Azure, uruchom polecenie az login:
az login
Zaloguj się do konta usługi Batch
Następnie zaloguj się do konta usługi Batch w interfejsie wiersza polecenia platformy Azure przy użyciu polecenia az batch account login . Ten krok zapewnia dostęp do poleceń usługi Batch. Następnie można zarządzać zasobami usługi Batch, takimi jak pule, prace i zadania.
Konto usługi Batch można uwierzytelnić na dwa sposoby w interfejsie wiersza polecenia platformy Azure. Domyślną metodą jest uwierzytelnianie przy użyciu identyfikatora Entra firmy Microsoft. W większości scenariuszy zalecamy użycie tej metody. Inną opcją jest użycie uwierzytelniania za pomocą klucza współużytkowanego.
Jeśli tworzysz skrypty interfejsu wiersza polecenia platformy Azure w celu zautomatyzowania poleceń usługi Batch, możesz użyć jednej z metod uwierzytelniania. W niektórych scenariuszach uwierzytelnianie klucza współdzielonego może być prostsze niż utworzenie jednostki usługi.
Uwierzytelnianie przy użyciu usługi Microsoft Entra ID
Domyślną metodą uwierzytelniania przy użyciu konta usługi Batch jest identyfikator Entra firmy Microsoft. Po interaktywnym logowaniu się do Azure CLI lub przy użyciu jednostki usługi, możesz użyć tych samych poświadczeń w pamięci podręcznej, aby zalogować się do konta Batch za pomocą Microsoft Entra ID. Ta metoda uwierzytelniania oferuje również kontrolę dostępu opartą na rolach platformy Azure (Azure RBAC). W przypadku kontroli dostępu opartej na rolach platformy Azure dostęp użytkowników zależy od przypisanej roli, a nie kluczy kont. Wystarczy zarządzać rolami platformy Azure, a nie kluczami konta. Identyfikator Entra firmy Microsoft obsługuje następnie dostęp i uwierzytelnianie.
Aby zalogować się do konta usługi Batch przy użyciu identyfikatora Microsoft Entra ID, uruchom polecenie az batch login. Pamiętaj, aby uwzględnić parametry wymagane dla nazwy konta usługi Batch (-n) i nazwy grupy zasobów (-g).
az batch account login -g <your-resource-group> -n <your-batch-account>
Uwierzytelnianie przy użyciu klucza współużytkowanego
Możesz również użyć uwierzytelniania klucza współdzielonego , aby zalogować się do konta usługi Batch. Ten sposób działania używa kluczy dostępu do Twojego konta do uwierzytelniania poleceń Azure CLI dla usługi Batch.
Aby zalogować się do konta usługi Batch przy użyciu uwierzytelniania za pomocą klucza współużytkowanego, uruchom polecenie az batch login z parametrem --shared-key-auth. Pamiętaj, aby uwzględnić parametry wymagane dla nazwy konta usługi Batch (-n) i nazwy grupy zasobów (-g).
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Nauka poleceń Batch
Dokumentacja referencyjna interfejsu wiersza polecenia platformy Azure zawiera listę wszystkich poleceń interfejsu wiersza polecenia platformy Azure dla usługi Batch.
Aby wyświetlić listę wszystkich poleceń usługi Batch w interfejsie wiersza polecenia platformy Azure, uruchom polecenie az batch -h.
Istnieje wiele przykładowych skryptów interfejsu wiersza polecenia dla typowych zadań usługi Batch. W tych przykładach pokazano, jak używać wielu dostępnych poleceń dla usługi Batch w interfejsie wiersza polecenia platformy Azure. Dowiesz się, jak tworzyć konta usługi Batch, pule, zadania oraz zarządzać nimi.
Używanie poleceń rozszerzenia Batch CLI
Za pomocą rozszerzenia interfejsu wiersza polecenia usługi Batch można uruchamiać zadania usługi Batch bez pisania kodu. Rozszerzenie udostępnia polecenia umożliwiające używanie szablonów JSON do tworzenia pul, zadań i zadań za pomocą interfejsu wiersza polecenia platformy Azure. Rozszerzenie udostępnia również polecenia umożliwiające nawiązanie połączenia z kontem usługi Azure Storage połączonym z kontem usługi Batch. Następnie możesz załadować pliki wejściowe zadania i je pobrać.
Tworzenie zasobów przy użyciu formatu JSON
Większość zasobów usługi Batch można utworzyć przy użyciu tylko parametrów wiersza polecenia. Niektóre funkcje wymagają podania pliku konfiguracji JSON zamiast tego. Plik JSON zawiera szczegóły konfiguracji nowego zasobu. Na przykład musisz użyć pliku JSON, aby określić pliki zasobów dla zadania uruchamiania.
Aby na przykład użyć pliku JSON do skonfigurowania nowego zasobu puli usługi Batch:
az batch pool <your-batch-pool-configuration>.json
Po określeniu pliku JSON dla nowego zasobu nie używaj innych parametrów w poleceniu. Usługa używa tylko pliku JSON do skonfigurowania zasobu.
Dokumentacja referencyjna interfejsu API REST usługi Batch zawiera listę dowolnej składni JSON wymaganej do utworzenia zasobu.
Aby wyświetlić składnię JSON wymaganą do utworzenia zasobu, zapoznaj się z dokumentacją referencyjną interfejsu API REST usługi Batch . Przejdź do sekcji Przykłady na stronie referencyjnej operacji zasobów. Następnie znajdź podsekcję o nazwie Dodaj <typ> zasobu. Na przykład Dodaj zadanie podstawowe. Użyj przykładowego kodu JSON jako szablonów dla plików konfiguracji.
Aby zapoznać się z przykładowym skryptem określającym plik JSON, zobacz Uruchamianie zadania i zadań za pomocą usługi Batch.
Wydajne wykonywanie zapytań o zasoby usługi Batch
Możesz wykonać zapytanie dotyczące konta usługi Batch i wyświetlić listę wszystkich zasobów przy użyciu list polecenia . Na przykład, aby wyświetlić listę pul na koncie oraz zadań w ramach zadania:
az batch pool list
az batch task list --job-id <your-job-id>
Aby ograniczyć ilość danych zwracanych przez zapytanie usługi Batch, określ klauzulę OData. Wszystkie filtrowanie odbywa się po stronie serwera, więc otrzymujesz tylko żądane dane. Użyj tych klauzul OData, aby zaoszczędzić przepustowość i czas w operacjach list. Aby uzyskać więcej informacji, zobacz Projektowanie wydajnych zapytań list dla zasobów usługi Batch.
| Klauzula | Opis |
|---|---|
--select-clause [select-clause] |
Zwraca podzbiór właściwości dla każdej jednostki. |
--filter-clause [filter-clause] |
Zwraca tylko jednostki zgodne z określonym wyrażeniem OData. |
--expand-clause [expand-clause] |
Uzyskuje informacje o jednostce w jednym podstawowym wywołaniu REST. Klauzula expand obecnie obsługuje tylko stats właściwość . |
Aby zapoznać się z przykładowym skryptem pokazującym użycie tych klauzul, zobacz Run a job and tasks with Batch.
Rozwiązywanie problemów
Aby uzyskać pomoc dotyczącą dowolnego polecenia Batch, dodaj -h na końcu polecenia. Nie dodawaj innych opcji. Aby na przykład uzyskać pomoc dotyczącą tworzenia konta usługi Batch, uruchom polecenie az batch account create -h.
Aby zwrócić szczegółowe dane wyjściowe polecenia, dodaj -v lub -vv na końcu polecenia. Użyj tych przełączników, aby wyświetlić pełne komunikaty błędów. Flaga -vv zwraca rzeczywiste żądania REST i odpowiedzi.
Aby wyświetlić dane wyjściowe polecenia w formacie JSON, dodaj --json na końcu polecenia. Aby na przykład wyświetlić właściwości puli o nazwie pool001, uruchom polecenie az batch pool show pool001 --json. Następnie skopiuj i zmodyfikuj dane wyjściowe, aby utworzyć zasoby usługi Batch przy użyciu pliku konfiguracji JSON.
Ogólne rozwiązywanie problemów z interfejsem wiersza polecenia platformy Azure
Interfejs wiersza poleceń platformy Azure może działać w kilku środowiskach powłoki, ale z drobnymi różnicami w formacie. Jeśli masz nieoczekiwane wyniki za pomocą poleceń interfejsu wiersza polecenia platformy Azure, zobacz Jak pomyślnie używać interfejsu wiersza polecenia platformy Azure.