Microsoft.Batch BatchAccounts/pools 2021-01-01
Definicja zasobu Bicep
Typ zasobu batchAccounts/pools można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Batch/batchAccounts/pools, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2021-01-01' = {
name: 'string'
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
osFamily: 'string'
osVersion: 'string'
}
virtualMachineConfiguration: {
containerConfiguration: {
containerImageNames: [
'string'
]
containerRegistries: [
{
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'DockerCompatible'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
diskEncryptionConfiguration: {
targets: [
'string'
]
}
extensions: [
{
autoUpgradeMinorVersion: bool
name: 'string'
protectedSettings: any()
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any()
type: 'string'
typeHandlerVersion: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
nodePlacementConfiguration: {
policy: 'string'
}
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
metadata: [
{
name: 'string'
value: 'string'
}
]
mountConfiguration: [
{
azureBlobFileSystemConfiguration: {
accountKey: 'string'
accountName: 'string'
blobfuseOptions: 'string'
containerName: 'string'
relativeMountPath: 'string'
sasKey: 'string'
}
azureFileShareConfiguration: {
accountKey: 'string'
accountName: 'string'
azureFileUrl: 'string'
mountOptions: 'string'
relativeMountPath: 'string'
}
cifsMountConfiguration: {
mountOptions: 'string'
password: 'string'
relativeMountPath: 'string'
source: 'string'
username: 'string'
}
nfsMountConfiguration: {
mountOptions: 'string'
relativeMountPath: 'string'
source: 'string'
}
}
]
networkConfiguration: {
endpointConfiguration: {
inboundNatPools: [
{
backendPort: int
frontendPortRangeEnd: int
frontendPortRangeStart: int
name: 'string'
networkSecurityGroupRules: [
{
access: 'string'
priority: int
sourceAddressPrefix: 'string'
sourcePortRanges: [
'string'
]
}
]
protocol: 'string'
}
]
}
publicIPAddressConfiguration: {
ipAddressIds: [
'string'
]
provision: 'string'
}
subnetId: 'string'
}
scaleSettings: {
autoScale: {
evaluationInterval: 'string'
formula: 'string'
}
fixedScale: {
nodeDeallocationOption: 'string'
resizeTimeout: 'string'
targetDedicatedNodes: int
targetLowPriorityNodes: int
}
}
startTask: {
commandLine: 'string'
containerSettings: {
containerRunOptions: 'string'
imageName: 'string'
registry: {
password: 'string'
registryServer: 'string'
username: 'string'
}
workingDirectory: 'string'
}
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
autoStorageContainerName: 'string'
blobPrefix: 'string'
fileMode: 'string'
filePath: 'string'
httpUrl: 'string'
storageContainerUrl: 'string'
}
]
userIdentity: {
autoUser: {
elevationLevel: 'string'
scope: 'string'
}
userName: 'string'
}
waitForSuccess: bool
}
taskSchedulingPolicy: {
nodeFillType: 'string'
}
taskSlotsPerNode: int
userAccounts: [
{
elevationLevel: 'string'
linuxUserConfiguration: {
gid: int
sshPrivateKey: 'string'
uid: int
}
name: 'string'
password: 'string'
windowsUserConfiguration: {
loginMode: 'string'
}
}
]
vmSize: 'string'
}
}
Wartości właściwości
batchAccounts/pools
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa zasobu Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w Bicep. |
ciąg (wymagany) Limit znaków: 1–64 Prawidłowe znaki: Alfanumeryczne, podkreślenia i łączniki. |
rodzic | W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu: batchAccounts |
tożsamość | Typ tożsamości używany dla puli usługi Batch. | BatchPoolIdentity |
Właściwości | Właściwości skojarzone z pulą. | |
BatchPoolIdentity
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ tożsamości używany dla puli usługi Batch. | "Brak" "UserAssigned" (wymagane) |
userAssignedIdentities | Lista tożsamości użytkowników skojarzonych z pulą usługi Batch. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | BatchPoolIdentityUserAssignedIdentities |
BatchPoolIdentityUserAssignedIdentities
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | Components81XseeSchemasBatchpoolidentityPropertiesUs... |
Components81XseeSchemasBatchpoolidentityPropertiesUs...
Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.
Właściwości puli
Nazwa | Opis | Wartość |
---|---|---|
applicationLicenses | Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem. | string[] |
applicationPackages | Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. | ApplicationPackageReference[] |
Certyfikaty | W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. | CertificateReference[] |
deploymentConfiguration | Użycie funkcji CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usług Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS). | DeploymentConfiguration |
displayName | Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. | struna |
interNodeCommunication | Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone". | "Wyłączone" "Włączone" |
metadane | Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. | MetadataItem[] |
mountConfiguration | Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse. | MountConfiguration[] |
networkConfiguration | Konfiguracja sieci dla puli. | NetworkConfiguration |
scaleSettings | Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes. | ScaleSettings |
startTask | W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli. | StartTask |
taskSchedulingPolicy | Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. | TaskSchedulingPolicy |
taskSlotsPerNode | Wartość domyślna to 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256. | Int |
userAccounts | Lista kont użytkowników do utworzenia w każdym węźle w puli. | userAccount[] |
vmSize | Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) (/azure/virtual-machines/sizes-general) lub Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2). | struna |
ApplicationPackageReference
Nazwa | Opis | Wartość |
---|---|---|
id | Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje. | ciąg (wymagany) |
Wersja | Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409. | struna |
CertificateReference
Nazwa | Opis | Wartość |
---|---|---|
id | W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula. | ciąg (wymagany) |
storeLocation | Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. | "CurrentUser" "LocalMachine" |
storeName | Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). Typowe nazwy sklepów to: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale można również użyć dowolnej niestandardowej nazwy sklepu. Wartość domyślna to Moja. | struna |
widoczność | Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu. | Tablica ciągów zawierająca dowolną z: "RemoteUser" "StartTask" "Zadanie" |
Konfiguracja wdrożenia
Nazwa | Opis | Wartość |
---|---|---|
cloudServiceConfiguration | Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. Nie można określić tej właściwości, jeśli konto usługi Batch zostało utworzone z właściwością poolAllocationMode ustawioną na wartość "UserSubscription". | CloudServiceConfiguration |
virtualMachineConfiguration | Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. | VirtualMachineConfiguration |
CloudServiceConfiguration
Nazwa | Opis | Wartość |
---|---|---|
osFamily | Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, co odpowiada systemowi Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | ciąg (wymagany) |
osVersion | Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych. | struna |
VirtualMachineConfiguration
Nazwa | Opis | Wartość |
---|---|---|
containerConfiguration | Jeśli zostanie określony, konfiguracja jest wykonywana w każdym węźle w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania podrzędne menedżera zadań uruchamiane w tej puli muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać. | ContainerConfiguration |
dataDisks | Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone do nich puste dyski danych. | DataDisk[] |
diskEncryptionConfiguration | Jeśli określono, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzłów. | DiskEncryptionConfiguration |
Rozszerzenia | Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle. | VMExtension[] |
imageReference | Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". | ImageReference (wymagane) |
licenseType | Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows. |
struna |
nodeAgentSkuId | Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". | ciąg (wymagany) |
nodePlacementConfiguration | Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli. | NodePlacementConfiguration |
windowsConfiguration | Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux. | WindowsConfiguration |
ContainerConfiguration
Nazwa | Opis | Wartość |
---|---|---|
containerImageNames | Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz będzie pochodzić z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem. | string[] |
containerRegistries | Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia w tym miejscu. | ContainerRegistry[] |
typ | Technologia kontenera do użycia. | "DockerCompatible" (wymagane) |
ContainerRegistry
Nazwa | Opis | Wartość |
---|---|---|
hasło | Hasło do logowania się na serwerze rejestru. | ciąg (wymagany) |
registryServer | W przypadku pominięcia wartość domyślna to "docker.io". | struna |
nazwa użytkownika | Nazwa użytkownika do logowania się na serwerze rejestru. | ciąg (wymagany) |
DataDisk
Nazwa | Opis | Wartość |
---|---|---|
Buforowanie | Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Brak" "ReadOnly" "ReadWrite" |
diskSizeGB | Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych. | int (wymagane) |
Jednostki lun | Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun. Wartość musi należeć do przedziału od 0 do 63 włącznie. | int (wymagane) |
storageAccountType | W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
Nazwa | Opis | Wartość |
---|---|---|
Cele | W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". | Tablica ciągów zawierająca dowolną z: "OsDisk" "TemporaryDisk" |
Rozszerzenie maszyny wirtualnej
Nazwa | Opis | Wartość |
---|---|---|
autoUpgradeMinorVersion | Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. | Bool |
nazwa | Nazwa rozszerzenia maszyny wirtualnej. | ciąg (wymagany) |
protectedSettings | Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. | W przypadku Bicep można użyć funkcji any(). |
provisionAfterExtensions | Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. | string[] |
wydawca | Nazwa wydawcy programu obsługi rozszerzeń. | ciąg (wymagany) |
Ustawienia | Ustawienia publiczne w formacie JSON dla rozszerzenia. | W przypadku Bicep można użyć funkcji any(). |
typ | Typ rozszerzeń. | ciąg (wymagany) |
typeHandlerVersion | Wersja programu obsługi skryptów. | struna |
ImageReference
Nazwa | Opis | Wartość |
---|---|---|
id | Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz z galerii obrazów udostępnionych musi mieć repliki w tym samym regionie co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | struna |
oferta | Na przykład UbuntuServer lub WindowsServer. | struna |
wydawca | Na przykład Canonical lub MicrosoftWindowsServer. | struna |
Numer jednostki magazynowej | Na przykład 18.04-LTS lub 2019-Datacenter. | struna |
Wersja | Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest". | struna |
NodePlacementConfiguration
Nazwa | Opis | Wartość |
---|---|---|
polityka | Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych. | "Regionalny" "Strefowe" |
Konfiguracja systemu Windows
Nazwa | Opis | Wartość |
---|---|---|
enableAutomaticUpdates | W przypadku pominięcia wartość domyślna to true. | Bool |
MetadataItem
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa elementu metadanych. | ciąg (wymagany) |
wartość | Wartość elementu metadanych. | ciąg (wymagany) |
InstalacjaKonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
azureBlobFileSystemConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | AzureBlobFileSystemConfiguration |
azureFileShareConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | AzureFileShareConfiguration |
cifsMountConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | CifsMountConfiguration |
nfsMountConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | NFSMountConfiguration |
AzureBlobFileSystemConfiguration
Nazwa | Opis | Wartość |
---|---|---|
accountKey | Ta właściwość wzajemnie wyklucza się z sygnaturą sasKey i należy określić jedną z nich. | struna |
accountName | Nazwa konta usługi Azure Storage. | ciąg (wymagany) |
blobfuseOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
containerName | Nazwa kontenera usługi Azure Blob Storage. | ciąg (wymagany) |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
sasKey | Ta właściwość wzajemnie wyklucza się z kluczem accountKey i należy określić jedną z nich. | struna |
AzureFileShareConfiguration
Nazwa | Opis | Wartość |
---|---|---|
accountKey | Klucz konta usługi Azure Storage. | ciąg (wymagany) |
accountName | Nazwa konta usługi Azure Storage. | ciąg (wymagany) |
azureFileUrl | Jest to formularz "https://{account}.file.core.windows.net/". | ciąg (wymagany) |
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
CifsMountConfiguration
Nazwa | Opis | Wartość |
---|---|---|
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
hasło | Hasło używane do uwierzytelniania w systemie plików CIFS. | ciąg (wymagany) |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
źródło | Identyfikator URI systemu plików do zainstalowania. | ciąg (wymagany) |
nazwa użytkownika | Użytkownik do użycia do uwierzytelniania w systemie plików CIFS. | ciąg (wymagany) |
NFSMountConfiguration
Nazwa | Opis | Wartość |
---|---|---|
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
źródło | Identyfikator URI systemu plików do zainstalowania. | ciąg (wymagany) |
Konfiguracja sieci
Nazwa | Opis | Wartość |
---|---|---|
endpointConfiguration | Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. | PoolEndpointConfiguration |
publicIPAddressConfiguration | Ta właściwość jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. | PublicIPAddressConfiguration |
subnetId | Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (RBAC) dla określonej sieci wirtualnej. Określona podsieć musi zezwalać na komunikację z usługi Azure Batch, aby móc planować zadania w węzłach obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych przy użyciu konfiguracji usługi w chmurze włącz porty 10100, 20100 i 30100. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. W przypadku pul cloudServiceConfiguration obsługiwane są tylko klasyczne sieci wirtualne. Aby uzyskać więcej informacji, zobacz: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | struna |
PoolEndpointConfiguration
Nazwa | Opis | Wartość |
---|---|---|
inboundNatPools | Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. | inboundNatPool[] (wymagane) |
InboundNatPool
Nazwa | Opis | Wartość |
---|---|---|
backendPort | Musi to być unikatowe w puli usługi Batch. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 22, 3389, 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
frontendPortRangeEnd | Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
frontendPortRangeStart | Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
nazwa | Nazwa musi być unikatowa w puli usługi Batch, może zawierać litery, cyfry, podkreślenia, kropki i łączniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano nieprawidłowe wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | ciąg (wymagany) |
networkSecurityGroupRules | Maksymalna liczba reguł, które można określić we wszystkich punktach końcowych w puli usługi Batch, wynosi 25. Jeśli nie określono żadnych reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | NetworkSecurityGroupRule[] |
protokół | Protokół punktu końcowego. | "TCP" "UDP" (wymagane) |
NetworkSecurityGroupRule
Nazwa | Opis | Wartość |
---|---|---|
dostęp | Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. | "Zezwalaj" "Odmów" (wymagane) |
priorytet | Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
sourceAddressPrefix | Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | ciąg (wymagany) |
sourcePortRanges | Prawidłowe wartości to "*" (dla wszystkich portów 0–65535) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *. | string[] |
PublicIPAddressConfiguration
Nazwa | Opis | Wartość |
---|---|---|
ipAddressIds | Liczba adresów IP określonych tutaj ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów o niskim priorytcie można przydzielić dla każdego publicznego adresu IP. Na przykład pula wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
zaopatrzenie | Wartość domyślna to BatchManaged | "BatchManaged" "NoPublicIPAddresses" "UserManaged" |
ScaleSettings
Nazwa | Opis | Wartość |
---|---|---|
autoSkaluj | Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości. | autoskalowania |
fixedScale | Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości. | FixedScaleSettings |
AutoskalowanieUstawienia
Nazwa | Opis | Wartość |
---|---|---|
evaluationInterval | W przypadku pominięcia wartość domyślna to 15 minut (PT15M). | struna |
formuła | Formuła dla żądanej liczby węzłów obliczeniowych w puli. | ciąg (wymagany) |
FixedScaleSettings
Nazwa | Opis | Wartość |
---|---|---|
nodeDeallocationOption | W przypadku pominięcia wartość domyślna to Requeue. | "Requeue" "RetainedData" "TaskCompletion" "Zakończ" |
resizeTimeout | Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). | struna |
targetDedicatedNodes | Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. | Int |
targetLowPriorityNodes | Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. | Int |
StartTask
Nazwa | Opis | Wartość |
---|---|---|
commandLine | Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask. | struna |
containerSettings | Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów usługi Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadań są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. | TaskContainerSettings |
environmentSettings | Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. | EnvironmentSetting[] |
maxTaskRetryCount | Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie maksymalnie 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu. | Int |
resourceFiles | Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. | ResourceFile[] |
userIdentity | W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania. | UserIdentity |
waitForSuccess | Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to true. | Bool |
TaskContainerSettings
Nazwa | Opis | Wartość |
---|---|---|
containerRunOptions | Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. | struna |
imageName | Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli w nazwie obrazu nie podano żadnego tagu, tag ":latest" jest używany jako domyślny. | ciąg (wymagany) |
rejestr | To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli. | ContainerRegistry |
workingDirectory | Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory". | "ContainerImageDefault" "TaskWorkingDirectory" |
EnvironmentSetting
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa zmiennej środowiskowej. | ciąg (wymagany) |
wartość | Wartość zmiennej środowiskowej. | struna |
Plik zasobu
Nazwa | Opis | Wartość |
---|---|---|
autoStorageContainerName | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. | struna |
BlobPrefix | Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze. | struna |
fileMode | Ta właściwość ma zastosowanie tylko do plików pobieranych do węzłów obliczeniowych systemu Linux. Zostanie on zignorowany, jeśli zostanie określony dla elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770. | struna |
filePath | Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy filePath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może przerwać katalogu roboczego zadania (na przykład przy użyciu ".". | struna |
httpUrl | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL jest usługą Azure Blob Storage, musi być czytelny przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. | struna |
storageContainerUrl | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w obiekcie blob lub ustaw listę ACL dla obiektu blob lub jego kontenera, aby zezwolić na dostęp publiczny. | struna |
Identyfikator użytkownika
Nazwa | Opis | Wartość |
---|---|---|
autoużytkownik | Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. | AutoUserSpecification |
userName | Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. | struna |
AutoUserSpecification
Nazwa | Opis | Wartość |
---|---|---|
elevationLevel | Wartość domyślna to nonAdmin. | "Administrator" "NonAdmin" |
zakres | Wartość domyślna to Pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Jeśli na przykład zadanie wycisza rejestr w sposób, który może mieć wpływ na inne zadania, lub jeśli certyfikaty zostały określone w puli, które nie powinny być dostępne przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania. | "Pula" "Zadanie" |
TaskSchedulingPolicy
Nazwa | Opis | Wartość |
---|---|---|
nodeFillType | Sposób dystrybucji zadań między węzłami obliczeniowymi. | "Pack" "Spread" (wymagane) |
UserAccount
Nazwa | Opis | Wartość |
---|---|---|
elevationLevel | nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin. | "Administrator" "NonAdmin" |
linuxUserConfiguration | Ta właściwość jest ignorowana, jeśli jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych. | LinuxUserConfiguration |
nazwa | Nazwa konta użytkownika. | ciąg (wymagany) |
hasło | Hasło do konta użytkownika. | ciąg (wymagany) |
windowsUserConfiguration | Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie określono wartości i w puli systemu Windows, użytkownik zostanie utworzony przy użyciu opcji domyślnych. | WindowsUserConfiguration |
LinuxUserConfiguration
Nazwa | Opis | Wartość |
---|---|---|
Gid | Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid. | Int |
sshPrivateKey | Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznego konfigurowania uwierzytelniania opartego na kluczu asymetrycznym dla protokołu SSH między węzłami w puli systemu Linux, gdy właściwość enableInterNodeCommunication puli ma wartość true (jest ignorowana, jeśli właściwość enableInterNodeCommunication ma wartość false). Robi to przez umieszczenie pary kluczy w katalogu .ssh użytkownika. Jeśli nie zostanie określony, protokół SSH bez hasła nie jest skonfigurowany między węzłami (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika). | struna |
Uid | Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid. | Int |
WindowsUserConfiguration
Nazwa | Opis | Wartość |
---|---|---|
loginMode | Określa tryb logowania użytkownika. Wartość domyślna dla pul VirtualMachineConfiguration to tryb interaktywny, a w przypadku pul CloudServiceConfiguration jest tryb wsadowy. | "Batch" "Interakcyjny" |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Szablon | Opis |
---|---|
puli usługi Azure Batch bez publicznych adresów IP wdrażanie |
Ten szablon tworzy uproszczoną pulę komunikacji węzłów usługi Azure Batch bez publicznych adresów IP. |
Definicja zasobu szablonu usługi ARM
Typ zasobu batchAccounts/pools można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Batch/batchAccounts/pools, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Batch/batchAccounts/pools",
"apiVersion": "2021-01-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"applicationLicenses": [ "string" ],
"applicationPackages": [
{
"id": "string",
"version": "string"
}
],
"certificates": [
{
"id": "string",
"storeLocation": "string",
"storeName": "string",
"visibility": [ "string" ]
}
],
"deploymentConfiguration": {
"cloudServiceConfiguration": {
"osFamily": "string",
"osVersion": "string"
},
"virtualMachineConfiguration": {
"containerConfiguration": {
"containerImageNames": [ "string" ],
"containerRegistries": [
{
"password": "string",
"registryServer": "string",
"username": "string"
}
],
"type": "DockerCompatible"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"diskEncryptionConfiguration": {
"targets": [ "string" ]
},
"extensions": [
{
"autoUpgradeMinorVersion": "bool",
"name": "string",
"protectedSettings": {},
"provisionAfterExtensions": [ "string" ],
"publisher": "string",
"settings": {},
"type": "string",
"typeHandlerVersion": "string"
}
],
"imageReference": {
"id": "string",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"licenseType": "string",
"nodeAgentSkuId": "string",
"nodePlacementConfiguration": {
"policy": "string"
},
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountKey": "string",
"accountName": "string",
"blobfuseOptions": "string",
"containerName": "string",
"relativeMountPath": "string",
"sasKey": "string"
},
"azureFileShareConfiguration": {
"accountKey": "string",
"accountName": "string",
"azureFileUrl": "string",
"mountOptions": "string",
"relativeMountPath": "string"
},
"cifsMountConfiguration": {
"mountOptions": "string",
"password": "string",
"relativeMountPath": "string",
"source": "string",
"username": "string"
},
"nfsMountConfiguration": {
"mountOptions": "string",
"relativeMountPath": "string",
"source": "string"
}
}
],
"networkConfiguration": {
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": "int",
"frontendPortRangeEnd": "int",
"frontendPortRangeStart": "int",
"name": "string",
"networkSecurityGroupRules": [
{
"access": "string",
"priority": "int",
"sourceAddressPrefix": "string",
"sourcePortRanges": [ "string" ]
}
],
"protocol": "string"
}
]
},
"publicIPAddressConfiguration": {
"ipAddressIds": [ "string" ],
"provision": "string"
},
"subnetId": "string"
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "string",
"formula": "string"
},
"fixedScale": {
"nodeDeallocationOption": "string",
"resizeTimeout": "string",
"targetDedicatedNodes": "int",
"targetLowPriorityNodes": "int"
}
},
"startTask": {
"commandLine": "string",
"containerSettings": {
"containerRunOptions": "string",
"imageName": "string",
"registry": {
"password": "string",
"registryServer": "string",
"username": "string"
},
"workingDirectory": "string"
},
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"autoStorageContainerName": "string",
"blobPrefix": "string",
"fileMode": "string",
"filePath": "string",
"httpUrl": "string",
"storageContainerUrl": "string"
}
],
"userIdentity": {
"autoUser": {
"elevationLevel": "string",
"scope": "string"
},
"userName": "string"
},
"waitForSuccess": "bool"
},
"taskSchedulingPolicy": {
"nodeFillType": "string"
},
"taskSlotsPerNode": "int",
"userAccounts": [
{
"elevationLevel": "string",
"linuxUserConfiguration": {
"gid": "int",
"sshPrivateKey": "string",
"uid": "int"
},
"name": "string",
"password": "string",
"windowsUserConfiguration": {
"loginMode": "string"
}
}
],
"vmSize": "string"
}
}
Wartości właściwości
batchAccounts/pools
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ zasobu | "Microsoft.Batch/batchAccounts/pools" |
apiVersion | Wersja interfejsu API zasobów | '2021-01-01' |
nazwa | Nazwa zasobu Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON. |
ciąg (wymagany) Limit znaków: 1–64 Prawidłowe znaki: Alfanumeryczne, podkreślenia i łączniki. |
tożsamość | Typ tożsamości używany dla puli usługi Batch. | BatchPoolIdentity |
Właściwości | Właściwości skojarzone z pulą. | |
BatchPoolIdentity
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ tożsamości używany dla puli usługi Batch. | "Brak" "UserAssigned" (wymagane) |
userAssignedIdentities | Lista tożsamości użytkowników skojarzonych z pulą usługi Batch. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | BatchPoolIdentityUserAssignedIdentities |
BatchPoolIdentityUserAssignedIdentities
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | Components81XseeSchemasBatchpoolidentityPropertiesUs... |
Components81XseeSchemasBatchpoolidentityPropertiesUs...
Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.
Właściwości puli
Nazwa | Opis | Wartość |
---|---|---|
applicationLicenses | Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem. | string[] |
applicationPackages | Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. | ApplicationPackageReference[] |
Certyfikaty | W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. | CertificateReference[] |
deploymentConfiguration | Użycie funkcji CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usług Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS). | DeploymentConfiguration |
displayName | Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. | struna |
interNodeCommunication | Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone". | "Wyłączone" "Włączone" |
metadane | Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. | MetadataItem[] |
mountConfiguration | Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse. | MountConfiguration[] |
networkConfiguration | Konfiguracja sieci dla puli. | NetworkConfiguration |
scaleSettings | Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes. | ScaleSettings |
startTask | W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli. | StartTask |
taskSchedulingPolicy | Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. | TaskSchedulingPolicy |
taskSlotsPerNode | Wartość domyślna to 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256. | Int |
userAccounts | Lista kont użytkowników do utworzenia w każdym węźle w puli. | userAccount[] |
vmSize | Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) (/azure/virtual-machines/sizes-general) lub Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2). | struna |
ApplicationPackageReference
Nazwa | Opis | Wartość |
---|---|---|
id | Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje. | ciąg (wymagany) |
Wersja | Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409. | struna |
CertificateReference
Nazwa | Opis | Wartość |
---|---|---|
id | W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula. | ciąg (wymagany) |
storeLocation | Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. | "CurrentUser" "LocalMachine" |
storeName | Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). Typowe nazwy sklepów to: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale można również użyć dowolnej niestandardowej nazwy sklepu. Wartość domyślna to Moja. | struna |
widoczność | Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu. | Tablica ciągów zawierająca dowolną z: "RemoteUser" "StartTask" "Zadanie" |
Konfiguracja wdrożenia
Nazwa | Opis | Wartość |
---|---|---|
cloudServiceConfiguration | Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. Nie można określić tej właściwości, jeśli konto usługi Batch zostało utworzone z właściwością poolAllocationMode ustawioną na wartość "UserSubscription". | CloudServiceConfiguration |
virtualMachineConfiguration | Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. | VirtualMachineConfiguration |
CloudServiceConfiguration
Nazwa | Opis | Wartość |
---|---|---|
osFamily | Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, co odpowiada systemowi Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | ciąg (wymagany) |
osVersion | Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych. | struna |
VirtualMachineConfiguration
Nazwa | Opis | Wartość |
---|---|---|
containerConfiguration | Jeśli zostanie określony, konfiguracja jest wykonywana w każdym węźle w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania podrzędne menedżera zadań uruchamiane w tej puli muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać. | ContainerConfiguration |
dataDisks | Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone do nich puste dyski danych. | DataDisk[] |
diskEncryptionConfiguration | Jeśli określono, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzłów. | DiskEncryptionConfiguration |
Rozszerzenia | Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle. | VMExtension[] |
imageReference | Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". | ImageReference (wymagane) |
licenseType | Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows. |
struna |
nodeAgentSkuId | Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". | ciąg (wymagany) |
nodePlacementConfiguration | Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli. | NodePlacementConfiguration |
windowsConfiguration | Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux. | WindowsConfiguration |
ContainerConfiguration
Nazwa | Opis | Wartość |
---|---|---|
containerImageNames | Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz będzie pochodzić z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem. | string[] |
containerRegistries | Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia w tym miejscu. | ContainerRegistry[] |
typ | Technologia kontenera do użycia. | "DockerCompatible" (wymagane) |
ContainerRegistry
Nazwa | Opis | Wartość |
---|---|---|
hasło | Hasło do logowania się na serwerze rejestru. | ciąg (wymagany) |
registryServer | W przypadku pominięcia wartość domyślna to "docker.io". | struna |
nazwa użytkownika | Nazwa użytkownika do logowania się na serwerze rejestru. | ciąg (wymagany) |
DataDisk
Nazwa | Opis | Wartość |
---|---|---|
Buforowanie | Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Brak" "ReadOnly" "ReadWrite" |
diskSizeGB | Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych. | int (wymagane) |
Jednostki lun | Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun. Wartość musi należeć do przedziału od 0 do 63 włącznie. | int (wymagane) |
storageAccountType | W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
Nazwa | Opis | Wartość |
---|---|---|
Cele | W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". | Tablica ciągów zawierająca dowolną z: "OsDisk" "TemporaryDisk" |
Rozszerzenie maszyny wirtualnej
Nazwa | Opis | Wartość |
---|---|---|
autoUpgradeMinorVersion | Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. | Bool |
nazwa | Nazwa rozszerzenia maszyny wirtualnej. | ciąg (wymagany) |
protectedSettings | Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. | |
provisionAfterExtensions | Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. | string[] |
wydawca | Nazwa wydawcy programu obsługi rozszerzeń. | ciąg (wymagany) |
Ustawienia | Ustawienia publiczne w formacie JSON dla rozszerzenia. | |
typ | Typ rozszerzeń. | ciąg (wymagany) |
typeHandlerVersion | Wersja programu obsługi skryptów. | struna |
ImageReference
Nazwa | Opis | Wartość |
---|---|---|
id | Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz z galerii obrazów udostępnionych musi mieć repliki w tym samym regionie co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | struna |
oferta | Na przykład UbuntuServer lub WindowsServer. | struna |
wydawca | Na przykład Canonical lub MicrosoftWindowsServer. | struna |
Numer jednostki magazynowej | Na przykład 18.04-LTS lub 2019-Datacenter. | struna |
Wersja | Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest". | struna |
NodePlacementConfiguration
Nazwa | Opis | Wartość |
---|---|---|
polityka | Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych. | "Regionalny" "Strefowe" |
Konfiguracja systemu Windows
Nazwa | Opis | Wartość |
---|---|---|
enableAutomaticUpdates | W przypadku pominięcia wartość domyślna to true. | Bool |
MetadataItem
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa elementu metadanych. | ciąg (wymagany) |
wartość | Wartość elementu metadanych. | ciąg (wymagany) |
InstalacjaKonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
azureBlobFileSystemConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | AzureBlobFileSystemConfiguration |
azureFileShareConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | AzureFileShareConfiguration |
cifsMountConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | CifsMountConfiguration |
nfsMountConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | NFSMountConfiguration |
AzureBlobFileSystemConfiguration
Nazwa | Opis | Wartość |
---|---|---|
accountKey | Ta właściwość wzajemnie wyklucza się z sygnaturą sasKey i należy określić jedną z nich. | struna |
accountName | Nazwa konta usługi Azure Storage. | ciąg (wymagany) |
blobfuseOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
containerName | Nazwa kontenera usługi Azure Blob Storage. | ciąg (wymagany) |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
sasKey | Ta właściwość wzajemnie wyklucza się z kluczem accountKey i należy określić jedną z nich. | struna |
AzureFileShareConfiguration
Nazwa | Opis | Wartość |
---|---|---|
accountKey | Klucz konta usługi Azure Storage. | ciąg (wymagany) |
accountName | Nazwa konta usługi Azure Storage. | ciąg (wymagany) |
azureFileUrl | Jest to formularz "https://{account}.file.core.windows.net/". | ciąg (wymagany) |
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
CifsMountConfiguration
Nazwa | Opis | Wartość |
---|---|---|
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
hasło | Hasło używane do uwierzytelniania w systemie plików CIFS. | ciąg (wymagany) |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
źródło | Identyfikator URI systemu plików do zainstalowania. | ciąg (wymagany) |
nazwa użytkownika | Użytkownik do użycia do uwierzytelniania w systemie plików CIFS. | ciąg (wymagany) |
NFSMountConfiguration
Nazwa | Opis | Wartość |
---|---|---|
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
źródło | Identyfikator URI systemu plików do zainstalowania. | ciąg (wymagany) |
Konfiguracja sieci
Nazwa | Opis | Wartość |
---|---|---|
endpointConfiguration | Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. | PoolEndpointConfiguration |
publicIPAddressConfiguration | Ta właściwość jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. | PublicIPAddressConfiguration |
subnetId | Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (RBAC) dla określonej sieci wirtualnej. Określona podsieć musi zezwalać na komunikację z usługi Azure Batch, aby móc planować zadania w węzłach obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych przy użyciu konfiguracji usługi w chmurze włącz porty 10100, 20100 i 30100. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. W przypadku pul cloudServiceConfiguration obsługiwane są tylko klasyczne sieci wirtualne. Aby uzyskać więcej informacji, zobacz: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | struna |
PoolEndpointConfiguration
Nazwa | Opis | Wartość |
---|---|---|
inboundNatPools | Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. | inboundNatPool[] (wymagane) |
InboundNatPool
Nazwa | Opis | Wartość |
---|---|---|
backendPort | Musi to być unikatowe w puli usługi Batch. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 22, 3389, 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
frontendPortRangeEnd | Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
frontendPortRangeStart | Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
nazwa | Nazwa musi być unikatowa w puli usługi Batch, może zawierać litery, cyfry, podkreślenia, kropki i łączniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano nieprawidłowe wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | ciąg (wymagany) |
networkSecurityGroupRules | Maksymalna liczba reguł, które można określić we wszystkich punktach końcowych w puli usługi Batch, wynosi 25. Jeśli nie określono żadnych reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | NetworkSecurityGroupRule[] |
protokół | Protokół punktu końcowego. | "TCP" "UDP" (wymagane) |
NetworkSecurityGroupRule
Nazwa | Opis | Wartość |
---|---|---|
dostęp | Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. | "Zezwalaj" "Odmów" (wymagane) |
priorytet | Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
sourceAddressPrefix | Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | ciąg (wymagany) |
sourcePortRanges | Prawidłowe wartości to "*" (dla wszystkich portów 0–65535) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *. | string[] |
PublicIPAddressConfiguration
Nazwa | Opis | Wartość |
---|---|---|
ipAddressIds | Liczba adresów IP określonych tutaj ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów o niskim priorytcie można przydzielić dla każdego publicznego adresu IP. Na przykład pula wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
zaopatrzenie | Wartość domyślna to BatchManaged | "BatchManaged" "NoPublicIPAddresses" "UserManaged" |
ScaleSettings
Nazwa | Opis | Wartość |
---|---|---|
autoSkaluj | Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości. | autoskalowania |
fixedScale | Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości. | FixedScaleSettings |
AutoskalowanieUstawienia
Nazwa | Opis | Wartość |
---|---|---|
evaluationInterval | W przypadku pominięcia wartość domyślna to 15 minut (PT15M). | struna |
formuła | Formuła dla żądanej liczby węzłów obliczeniowych w puli. | ciąg (wymagany) |
FixedScaleSettings
Nazwa | Opis | Wartość |
---|---|---|
nodeDeallocationOption | W przypadku pominięcia wartość domyślna to Requeue. | "Requeue" "RetainedData" "TaskCompletion" "Zakończ" |
resizeTimeout | Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). | struna |
targetDedicatedNodes | Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. | Int |
targetLowPriorityNodes | Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. | Int |
StartTask
Nazwa | Opis | Wartość |
---|---|---|
commandLine | Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask. | struna |
containerSettings | Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów usługi Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadań są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. | TaskContainerSettings |
environmentSettings | Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. | EnvironmentSetting[] |
maxTaskRetryCount | Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie maksymalnie 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu. | Int |
resourceFiles | Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. | ResourceFile[] |
userIdentity | W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania. | UserIdentity |
waitForSuccess | Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to true. | Bool |
TaskContainerSettings
Nazwa | Opis | Wartość |
---|---|---|
containerRunOptions | Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. | struna |
imageName | Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli w nazwie obrazu nie podano żadnego tagu, tag ":latest" jest używany jako domyślny. | ciąg (wymagany) |
rejestr | To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli. | ContainerRegistry |
workingDirectory | Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory". | "ContainerImageDefault" "TaskWorkingDirectory" |
EnvironmentSetting
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa zmiennej środowiskowej. | ciąg (wymagany) |
wartość | Wartość zmiennej środowiskowej. | struna |
Plik zasobu
Nazwa | Opis | Wartość |
---|---|---|
autoStorageContainerName | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. | struna |
BlobPrefix | Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze. | struna |
fileMode | Ta właściwość ma zastosowanie tylko do plików pobieranych do węzłów obliczeniowych systemu Linux. Zostanie on zignorowany, jeśli zostanie określony dla elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770. | struna |
filePath | Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy filePath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może przerwać katalogu roboczego zadania (na przykład przy użyciu ".". | struna |
httpUrl | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL jest usługą Azure Blob Storage, musi być czytelny przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. | struna |
storageContainerUrl | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w obiekcie blob lub ustaw listę ACL dla obiektu blob lub jego kontenera, aby zezwolić na dostęp publiczny. | struna |
Identyfikator użytkownika
Nazwa | Opis | Wartość |
---|---|---|
autoużytkownik | Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. | AutoUserSpecification |
userName | Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. | struna |
AutoUserSpecification
Nazwa | Opis | Wartość |
---|---|---|
elevationLevel | Wartość domyślna to nonAdmin. | "Administrator" "NonAdmin" |
zakres | Wartość domyślna to Pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Jeśli na przykład zadanie wycisza rejestr w sposób, który może mieć wpływ na inne zadania, lub jeśli certyfikaty zostały określone w puli, które nie powinny być dostępne przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania. | "Pula" "Zadanie" |
TaskSchedulingPolicy
Nazwa | Opis | Wartość |
---|---|---|
nodeFillType | Sposób dystrybucji zadań między węzłami obliczeniowymi. | "Pack" "Spread" (wymagane) |
UserAccount
Nazwa | Opis | Wartość |
---|---|---|
elevationLevel | nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin. | "Administrator" "NonAdmin" |
linuxUserConfiguration | Ta właściwość jest ignorowana, jeśli jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych. | LinuxUserConfiguration |
nazwa | Nazwa konta użytkownika. | ciąg (wymagany) |
hasło | Hasło do konta użytkownika. | ciąg (wymagany) |
windowsUserConfiguration | Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie określono wartości i w puli systemu Windows, użytkownik zostanie utworzony przy użyciu opcji domyślnych. | WindowsUserConfiguration |
LinuxUserConfiguration
Nazwa | Opis | Wartość |
---|---|---|
Gid | Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid. | Int |
sshPrivateKey | Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznego konfigurowania uwierzytelniania opartego na kluczu asymetrycznym dla protokołu SSH między węzłami w puli systemu Linux, gdy właściwość enableInterNodeCommunication puli ma wartość true (jest ignorowana, jeśli właściwość enableInterNodeCommunication ma wartość false). Robi to przez umieszczenie pary kluczy w katalogu .ssh użytkownika. Jeśli nie zostanie określony, protokół SSH bez hasła nie jest skonfigurowany między węzłami (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika). | struna |
Uid | Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid. | Int |
WindowsUserConfiguration
Nazwa | Opis | Wartość |
---|---|---|
loginMode | Określa tryb logowania użytkownika. Wartość domyślna dla pul VirtualMachineConfiguration to tryb interaktywny, a w przypadku pul CloudServiceConfiguration jest tryb wsadowy. | "Batch" "Interakcyjny" |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Szablon | Opis |
---|---|
puli usługi Azure Batch bez publicznych adresów IP wdrażanie |
Ten szablon tworzy uproszczoną pulę komunikacji węzłów usługi Azure Batch bez publicznych adresów IP. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu batchAccounts/pools można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Batch/batchAccounts/pools, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Batch/batchAccounts/pools@2021-01-01"
name = "string"
parent_id = "string"
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
applicationLicenses = [
"string"
]
applicationPackages = [
{
id = "string"
version = "string"
}
]
certificates = [
{
id = "string"
storeLocation = "string"
storeName = "string"
visibility = [
"string"
]
}
]
deploymentConfiguration = {
cloudServiceConfiguration = {
osFamily = "string"
osVersion = "string"
}
virtualMachineConfiguration = {
containerConfiguration = {
containerImageNames = [
"string"
]
containerRegistries = [
{
password = "string"
registryServer = "string"
username = "string"
}
]
type = "DockerCompatible"
}
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
diskEncryptionConfiguration = {
targets = [
"string"
]
}
extensions = [
{
autoUpgradeMinorVersion = bool
name = "string"
provisionAfterExtensions = [
"string"
]
publisher = "string"
type = "string"
typeHandlerVersion = "string"
}
]
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
nodePlacementConfiguration = {
policy = "string"
}
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
metadata = [
{
name = "string"
value = "string"
}
]
mountConfiguration = [
{
azureBlobFileSystemConfiguration = {
accountKey = "string"
accountName = "string"
blobfuseOptions = "string"
containerName = "string"
relativeMountPath = "string"
sasKey = "string"
}
azureFileShareConfiguration = {
accountKey = "string"
accountName = "string"
azureFileUrl = "string"
mountOptions = "string"
relativeMountPath = "string"
}
cifsMountConfiguration = {
mountOptions = "string"
password = "string"
relativeMountPath = "string"
source = "string"
username = "string"
}
nfsMountConfiguration = {
mountOptions = "string"
relativeMountPath = "string"
source = "string"
}
}
]
networkConfiguration = {
endpointConfiguration = {
inboundNatPools = [
{
backendPort = int
frontendPortRangeEnd = int
frontendPortRangeStart = int
name = "string"
networkSecurityGroupRules = [
{
access = "string"
priority = int
sourceAddressPrefix = "string"
sourcePortRanges = [
"string"
]
}
]
protocol = "string"
}
]
}
publicIPAddressConfiguration = {
ipAddressIds = [
"string"
]
provision = "string"
}
subnetId = "string"
}
scaleSettings = {
autoScale = {
evaluationInterval = "string"
formula = "string"
}
fixedScale = {
nodeDeallocationOption = "string"
resizeTimeout = "string"
targetDedicatedNodes = int
targetLowPriorityNodes = int
}
}
startTask = {
commandLine = "string"
containerSettings = {
containerRunOptions = "string"
imageName = "string"
registry = {
password = "string"
registryServer = "string"
username = "string"
}
workingDirectory = "string"
}
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
autoStorageContainerName = "string"
blobPrefix = "string"
fileMode = "string"
filePath = "string"
httpUrl = "string"
storageContainerUrl = "string"
}
]
userIdentity = {
autoUser = {
elevationLevel = "string"
scope = "string"
}
userName = "string"
}
waitForSuccess = bool
}
taskSchedulingPolicy = {
nodeFillType = "string"
}
taskSlotsPerNode = int
userAccounts = [
{
elevationLevel = "string"
linuxUserConfiguration = {
gid = int
sshPrivateKey = "string"
uid = int
}
name = "string"
password = "string"
windowsUserConfiguration = {
loginMode = "string"
}
}
]
vmSize = "string"
}
})
}
Wartości właściwości
batchAccounts/pools
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ zasobu | "Microsoft.Batch/batchAccounts/pools@2021-01-01" |
nazwa | Nazwa zasobu | ciąg (wymagany) Limit znaków: 1–64 Prawidłowe znaki: Alfanumeryczne, podkreślenia i łączniki. |
parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: batchAccounts |
tożsamość | Typ tożsamości używany dla puli usługi Batch. | BatchPoolIdentity |
Właściwości | Właściwości skojarzone z pulą. | |
BatchPoolIdentity
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ tożsamości używany dla puli usługi Batch. | "UserAssigned" (wymagane) |
identity_ids | Lista tożsamości użytkowników skojarzonych z pulą usługi Batch. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | Tablica identyfikatorów tożsamości użytkownika. |
BatchPoolIdentityUserAssignedIdentities
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | Components81XseeSchemasBatchpoolidentityPropertiesUs... |
Components81XseeSchemasBatchpoolidentityPropertiesUs...
Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.
Właściwości puli
Nazwa | Opis | Wartość |
---|---|---|
applicationLicenses | Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem. | string[] |
applicationPackages | Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. | ApplicationPackageReference[] |
Certyfikaty | W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. | CertificateReference[] |
deploymentConfiguration | Użycie funkcji CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usług Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS). | DeploymentConfiguration |
displayName | Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. | struna |
interNodeCommunication | Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone". | "Wyłączone" "Włączone" |
metadane | Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. | MetadataItem[] |
mountConfiguration | Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse. | MountConfiguration[] |
networkConfiguration | Konfiguracja sieci dla puli. | NetworkConfiguration |
scaleSettings | Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes. | ScaleSettings |
startTask | W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli. | StartTask |
taskSchedulingPolicy | Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. | TaskSchedulingPolicy |
taskSlotsPerNode | Wartość domyślna to 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256. | Int |
userAccounts | Lista kont użytkowników do utworzenia w każdym węźle w puli. | userAccount[] |
vmSize | Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) (/azure/virtual-machines/sizes-general) lub Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2). | struna |
ApplicationPackageReference
Nazwa | Opis | Wartość |
---|---|---|
id | Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje. | ciąg (wymagany) |
Wersja | Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409. | struna |
CertificateReference
Nazwa | Opis | Wartość |
---|---|---|
id | W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula. | ciąg (wymagany) |
storeLocation | Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. | "CurrentUser" "LocalMachine" |
storeName | Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). Typowe nazwy sklepów to: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale można również użyć dowolnej niestandardowej nazwy sklepu. Wartość domyślna to Moja. | struna |
widoczność | Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu. | Tablica ciągów zawierająca dowolną z: "RemoteUser" "StartTask" "Zadanie" |
Konfiguracja wdrożenia
Nazwa | Opis | Wartość |
---|---|---|
cloudServiceConfiguration | Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. Nie można określić tej właściwości, jeśli konto usługi Batch zostało utworzone z właściwością poolAllocationMode ustawioną na wartość "UserSubscription". | CloudServiceConfiguration |
virtualMachineConfiguration | Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. | VirtualMachineConfiguration |
CloudServiceConfiguration
Nazwa | Opis | Wartość |
---|---|---|
osFamily | Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, co odpowiada systemowi Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | ciąg (wymagany) |
osVersion | Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych. | struna |
VirtualMachineConfiguration
Nazwa | Opis | Wartość |
---|---|---|
containerConfiguration | Jeśli zostanie określony, konfiguracja jest wykonywana w każdym węźle w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania podrzędne menedżera zadań uruchamiane w tej puli muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać. | ContainerConfiguration |
dataDisks | Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone do nich puste dyski danych. | DataDisk[] |
diskEncryptionConfiguration | Jeśli określono, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzłów. | DiskEncryptionConfiguration |
Rozszerzenia | Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle. | VMExtension[] |
imageReference | Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". | ImageReference (wymagane) |
licenseType | Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows. |
struna |
nodeAgentSkuId | Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". | ciąg (wymagany) |
nodePlacementConfiguration | Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli. | NodePlacementConfiguration |
windowsConfiguration | Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux. | WindowsConfiguration |
ContainerConfiguration
Nazwa | Opis | Wartość |
---|---|---|
containerImageNames | Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz będzie pochodzić z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem. | string[] |
containerRegistries | Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia w tym miejscu. | ContainerRegistry[] |
typ | Technologia kontenera do użycia. | "DockerCompatible" (wymagane) |
ContainerRegistry
Nazwa | Opis | Wartość |
---|---|---|
hasło | Hasło do logowania się na serwerze rejestru. | ciąg (wymagany) |
registryServer | W przypadku pominięcia wartość domyślna to "docker.io". | struna |
nazwa użytkownika | Nazwa użytkownika do logowania się na serwerze rejestru. | ciąg (wymagany) |
DataDisk
Nazwa | Opis | Wartość |
---|---|---|
Buforowanie | Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Brak" "ReadOnly" "ReadWrite" |
diskSizeGB | Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych. | int (wymagane) |
Jednostki lun | Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun. Wartość musi należeć do przedziału od 0 do 63 włącznie. | int (wymagane) |
storageAccountType | W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
Nazwa | Opis | Wartość |
---|---|---|
Cele | W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". | Tablica ciągów zawierająca dowolną z: "OsDisk" "TemporaryDisk" |
Rozszerzenie maszyny wirtualnej
Nazwa | Opis | Wartość |
---|---|---|
autoUpgradeMinorVersion | Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. | Bool |
nazwa | Nazwa rozszerzenia maszyny wirtualnej. | ciąg (wymagany) |
protectedSettings | Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. | |
provisionAfterExtensions | Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. | string[] |
wydawca | Nazwa wydawcy programu obsługi rozszerzeń. | ciąg (wymagany) |
Ustawienia | Ustawienia publiczne w formacie JSON dla rozszerzenia. | |
typ | Typ rozszerzeń. | ciąg (wymagany) |
typeHandlerVersion | Wersja programu obsługi skryptów. | struna |
ImageReference
Nazwa | Opis | Wartość |
---|---|---|
id | Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz z galerii obrazów udostępnionych musi mieć repliki w tym samym regionie co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | struna |
oferta | Na przykład UbuntuServer lub WindowsServer. | struna |
wydawca | Na przykład Canonical lub MicrosoftWindowsServer. | struna |
Numer jednostki magazynowej | Na przykład 18.04-LTS lub 2019-Datacenter. | struna |
Wersja | Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest". | struna |
NodePlacementConfiguration
Nazwa | Opis | Wartość |
---|---|---|
polityka | Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych. | "Regionalny" "Strefowe" |
Konfiguracja systemu Windows
Nazwa | Opis | Wartość |
---|---|---|
enableAutomaticUpdates | W przypadku pominięcia wartość domyślna to true. | Bool |
MetadataItem
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa elementu metadanych. | ciąg (wymagany) |
wartość | Wartość elementu metadanych. | ciąg (wymagany) |
InstalacjaKonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
azureBlobFileSystemConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | AzureBlobFileSystemConfiguration |
azureFileShareConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | AzureFileShareConfiguration |
cifsMountConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | CifsMountConfiguration |
nfsMountConfiguration | Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. | NFSMountConfiguration |
AzureBlobFileSystemConfiguration
Nazwa | Opis | Wartość |
---|---|---|
accountKey | Ta właściwość wzajemnie wyklucza się z sygnaturą sasKey i należy określić jedną z nich. | struna |
accountName | Nazwa konta usługi Azure Storage. | ciąg (wymagany) |
blobfuseOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
containerName | Nazwa kontenera usługi Azure Blob Storage. | ciąg (wymagany) |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
sasKey | Ta właściwość wzajemnie wyklucza się z kluczem accountKey i należy określić jedną z nich. | struna |
AzureFileShareConfiguration
Nazwa | Opis | Wartość |
---|---|---|
accountKey | Klucz konta usługi Azure Storage. | ciąg (wymagany) |
accountName | Nazwa konta usługi Azure Storage. | ciąg (wymagany) |
azureFileUrl | Jest to formularz "https://{account}.file.core.windows.net/". | ciąg (wymagany) |
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
CifsMountConfiguration
Nazwa | Opis | Wartość |
---|---|---|
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
hasło | Hasło używane do uwierzytelniania w systemie plików CIFS. | ciąg (wymagany) |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
źródło | Identyfikator URI systemu plików do zainstalowania. | ciąg (wymagany) |
nazwa użytkownika | Użytkownik do użycia do uwierzytelniania w systemie plików CIFS. | ciąg (wymagany) |
NFSMountConfiguration
Nazwa | Opis | Wartość |
---|---|---|
mountOptions | Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. | struna |
relativeMountPath | Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. | ciąg (wymagany) |
źródło | Identyfikator URI systemu plików do zainstalowania. | ciąg (wymagany) |
Konfiguracja sieci
Nazwa | Opis | Wartość |
---|---|---|
endpointConfiguration | Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. | PoolEndpointConfiguration |
publicIPAddressConfiguration | Ta właściwość jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. | PublicIPAddressConfiguration |
subnetId | Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (RBAC) dla określonej sieci wirtualnej. Określona podsieć musi zezwalać na komunikację z usługi Azure Batch, aby móc planować zadania w węzłach obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych przy użyciu konfiguracji usługi w chmurze włącz porty 10100, 20100 i 30100. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. W przypadku pul cloudServiceConfiguration obsługiwane są tylko klasyczne sieci wirtualne. Aby uzyskać więcej informacji, zobacz: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | struna |
PoolEndpointConfiguration
Nazwa | Opis | Wartość |
---|---|---|
inboundNatPools | Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. | inboundNatPool[] (wymagane) |
InboundNatPool
Nazwa | Opis | Wartość |
---|---|---|
backendPort | Musi to być unikatowe w puli usługi Batch. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 22, 3389, 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
frontendPortRangeEnd | Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
frontendPortRangeStart | Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
nazwa | Nazwa musi być unikatowa w puli usługi Batch, może zawierać litery, cyfry, podkreślenia, kropki i łączniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano nieprawidłowe wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | ciąg (wymagany) |
networkSecurityGroupRules | Maksymalna liczba reguł, które można określić we wszystkich punktach końcowych w puli usługi Batch, wynosi 25. Jeśli nie określono żadnych reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | NetworkSecurityGroupRule[] |
protokół | Protokół punktu końcowego. | "TCP" "UDP" (wymagane) |
NetworkSecurityGroupRule
Nazwa | Opis | Wartość |
---|---|---|
dostęp | Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. | "Zezwalaj" "Odmów" (wymagane) |
priorytet | Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | int (wymagane) |
sourceAddressPrefix | Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. | ciąg (wymagany) |
sourcePortRanges | Prawidłowe wartości to "*" (dla wszystkich portów 0–65535) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *. | string[] |
PublicIPAddressConfiguration
Nazwa | Opis | Wartość |
---|---|---|
ipAddressIds | Liczba adresów IP określonych tutaj ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów o niskim priorytcie można przydzielić dla każdego publicznego adresu IP. Na przykład pula wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
zaopatrzenie | Wartość domyślna to BatchManaged | "BatchManaged" "NoPublicIPAddresses" "UserManaged" |
ScaleSettings
Nazwa | Opis | Wartość |
---|---|---|
autoSkaluj | Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości. | autoskalowania |
fixedScale | Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości. | FixedScaleSettings |
AutoskalowanieUstawienia
Nazwa | Opis | Wartość |
---|---|---|
evaluationInterval | W przypadku pominięcia wartość domyślna to 15 minut (PT15M). | struna |
formuła | Formuła dla żądanej liczby węzłów obliczeniowych w puli. | ciąg (wymagany) |
FixedScaleSettings
Nazwa | Opis | Wartość |
---|---|---|
nodeDeallocationOption | W przypadku pominięcia wartość domyślna to Requeue. | "Ponowne kolejki" "Zachowane dane" "TaskCompletion" "Zakończ" |
resizeTimeout | Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). | struna |
targetDedicatedNodes | Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. | Int |
targetLowPriorityNodes | Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. | Int |
StartTask
Nazwa | Opis | Wartość |
---|---|---|
commandLine | Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask. | struna |
containerSettings | Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów usługi Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadań są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. | TaskContainerSettings |
environmentSettings | Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. | EnvironmentSetting[] |
maxTaskRetryCount | Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie maksymalnie 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu. | Int |
resourceFiles | Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. | ResourceFile[] |
userIdentity | W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania. | UserIdentity |
waitForSuccess | Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to true. | Bool |
TaskContainerSettings
Nazwa | Opis | Wartość |
---|---|---|
containerRunOptions | Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. | struna |
imageName | Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli w nazwie obrazu nie podano żadnego tagu, tag ":latest" jest używany jako domyślny. | ciąg (wymagany) |
rejestr | To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli. | ContainerRegistry |
workingDirectory | Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory". | "ContainerImageDefault" "TaskWorkingDirectory" |
EnvironmentSetting
Nazwa | Opis | Wartość |
---|---|---|
nazwa | Nazwa zmiennej środowiskowej. | ciąg (wymagany) |
wartość | Wartość zmiennej środowiskowej. | struna |
Plik zasobu
Nazwa | Opis | Wartość |
---|---|---|
autoStorageContainerName | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. | struna |
BlobPrefix | Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze. | struna |
fileMode | Ta właściwość ma zastosowanie tylko do plików pobieranych do węzłów obliczeniowych systemu Linux. Zostanie on zignorowany, jeśli zostanie określony dla elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770. | struna |
filePath | Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy filePath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może przerwać katalogu roboczego zadania (na przykład przy użyciu ".". | struna |
httpUrl | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL jest usługą Azure Blob Storage, musi być czytelny przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. | struna |
storageContainerUrl | Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w obiekcie blob lub ustaw listę ACL dla obiektu blob lub jego kontenera, aby zezwolić na dostęp publiczny. | struna |
Identyfikator użytkownika
Nazwa | Opis | Wartość |
---|---|---|
autoużytkownik | Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. | AutoUserSpecification |
userName | Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. | struna |
AutoUserSpecification
Nazwa | Opis | Wartość |
---|---|---|
elevationLevel | Wartość domyślna to nonAdmin. | "Administrator" "NonAdmin" |
zakres | Wartość domyślna to Pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Jeśli na przykład zadanie wycisza rejestr w sposób, który może mieć wpływ na inne zadania, lub jeśli certyfikaty zostały określone w puli, które nie powinny być dostępne przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania. | "Pula" "Zadanie" |
TaskSchedulingPolicy
Nazwa | Opis | Wartość |
---|---|---|
nodeFillType | Sposób dystrybucji zadań między węzłami obliczeniowymi. | "Pack" "Spread" (wymagane) |
UserAccount
Nazwa | Opis | Wartość |
---|---|---|
elevationLevel | nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin. | "Administrator" "NonAdmin" |
linuxUserConfiguration | Ta właściwość jest ignorowana, jeśli jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych. | LinuxUserConfiguration |
nazwa | Nazwa konta użytkownika. | ciąg (wymagany) |
hasło | Hasło do konta użytkownika. | ciąg (wymagany) |
windowsUserConfiguration | Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie określono wartości i w puli systemu Windows, użytkownik zostanie utworzony przy użyciu opcji domyślnych. | WindowsUserConfiguration |
LinuxUserConfiguration
Nazwa | Opis | Wartość |
---|---|---|
Gid | Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid. | Int |
sshPrivateKey | Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznego konfigurowania uwierzytelniania opartego na kluczu asymetrycznym dla protokołu SSH między węzłami w puli systemu Linux, gdy właściwość enableInterNodeCommunication puli ma wartość true (jest ignorowana, jeśli właściwość enableInterNodeCommunication ma wartość false). Robi to przez umieszczenie pary kluczy w katalogu .ssh użytkownika. Jeśli nie zostanie określony, protokół SSH bez hasła nie jest skonfigurowany między węzłami (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika). | struna |
Uid | Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid. | Int |
WindowsUserConfiguration
Nazwa | Opis | Wartość |
---|---|---|
loginMode | Określa tryb logowania użytkownika. Wartość domyślna dla pul VirtualMachineConfiguration to tryb interaktywny, a w przypadku pul CloudServiceConfiguration jest tryb wsadowy. | "Batch" "Interakcyjne" |