Microsoft.Batch batchAccounts/pools 2022-01-01
- nejnovější
-
2024-07-01 - 2024-02-01
- 11. 11. 2023
- 2023-05-01
- 10. 10. 2022
-
2022-06-01 - 1. 1. 2022
- 2021-06-01
- 1. 1. 2021
-
2020-09-01 - 05. 5. 2020
- 2020-03-01
- 1. 8. 2019
-
2019-04-04 - 12. 12. 2018
-
2017-09-09
Definice prostředku Bicep
Typ prostředku batchAccounts/pools je možné nasadit s operacemi, které cílí:
- skupiny prostředků – viz příkazy nasazení skupiny prostředků
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Formát prostředku
Pokud chcete vytvořit prostředek Microsoft.Batch/batchAccounts/pools, přidejte do šablony následující bicep.
resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2022-01-01' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
name: 'string'
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: [
{
identityReference: {
resourceId: 'string'
}
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(Azure.Bicep.Types.Concrete.AnyType)
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any(Azure.Bicep.Types.Concrete.AnyType)
type: 'string'
typeHandlerVersion: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
nodePlacementConfiguration: {
policy: 'string'
}
osDisk: {
ephemeralOSDiskSettings: {
placement: 'CacheDisk'
}
}
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
metadata: [
{
name: 'string'
value: 'string'
}
]
mountConfiguration: [
{
azureBlobFileSystemConfiguration: {
accountKey: 'string'
accountName: 'string'
blobfuseOptions: 'string'
containerName: 'string'
identityReference: {
resourceId: '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: {
dynamicVNetAssignmentScope: 'string'
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: {
identityReference: {
resourceId: 'string'
}
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'
identityReference: {
resourceId: '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'
}
}
Hodnoty vlastností
ApplicationPackageReference
Jméno | Popis | Hodnota |
---|---|---|
id | ID balíčku aplikace, který se má nainstalovat. Musí se nacházet ve stejném účtu Batch jako fond. Může se jednat o odkaz na konkrétní verzi nebo výchozí verzi, pokud existuje. | string (povinné) |
verze | Pokud tuto hodnotu vynecháte a pro tuto aplikaci není zadána žádná výchozí verze, požadavek selže s kódem chyby InvalidApplicationPackageReferences. Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409. | řetězec |
Automatické škálováníSettings
Jméno | Popis | Hodnota |
---|---|---|
evaluationInterval | Pokud tuto hodnotu vynecháte, výchozí hodnota je 15 minut (PT15M). | řetězec |
vzorec | Vzorec pro požadovaný počet výpočetních uzlů ve fondu | string (povinné) |
AutoUserSpecification
Jméno | Popis | Hodnota |
---|---|---|
elevationLevel | Výchozí hodnota neníadmin. | Správce NonAdmin |
rozsah | Výchozí hodnota je Pool. Pokud fond používá Systém Windows, měla by být zadána hodnota Úlohy, pokud je vyžadována přísnější izolace mezi úlohami. Pokud například úloha ztlumí registr způsobem, který by mohl ovlivnit jiné úkoly, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné běžnými úkoly, ale měly by být přístupné podle počátečních úkolů. | "Bazén" Úkol |
AzureBlobFileSystemConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Tato vlastnost se vzájemně vylučují s sasKey i identitou; musí být zadána přesně jedna. | řetězec |
accountName | Název účtu úložiště Azure. | string (povinné) |
blobfuseOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
containerName | Název kontejneru služby Azure Blob Storage. | string (povinné) |
identityReference | Tato vlastnost se vzájemně vylučují s accountKey i sasKey; musí být zadána přesně jedna. | ComputeNodeIdentityReference |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
sasKey | Tato vlastnost se vzájemně vylučují s accountKey i identitou; musí být zadána přesně jedna. | řetězec |
AzureFileShareConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Klíč účtu služby Azure Storage. | string (povinné) |
accountName | Název účtu služby Azure Storage. | string (povinné) |
azureFileUrl | Toto je formulář "https://{account}.file.core.windows.net/". | string (povinné) |
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
BatchPoolIdentity
Jméno | Popis | Hodnota |
---|---|---|
typ | Typ identity, který se používá pro fond batch. | None (Žádný) UserAssigned (povinné) |
userAssignedIdentities | Seznam identit uživatelů přidružených k fondu Batch. | batchPoolIdentityUserAssignedIdentities |
BatchPoolIdentityUserAssignedIdentities
Jméno | Popis | Hodnota |
---|
CertificateReference
Jméno | Popis | Hodnota |
---|---|---|
id | Plně kvalifikované ID certifikátu, které se má nainstalovat do fondu. Musí se nacházet ve stejném účtu Batch jako fond. | string (povinné) |
storeLocation | Výchozí hodnota je currentUser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že je vytvořená pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři. | CurrentUser LocalMachine |
storeName | Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že je vytvořená pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale můžete také použít jakýkoli vlastní název úložiště. Výchozí hodnota je My. | řetězec |
viditelnost | Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu. | Řetězcové pole obsahující některou z těchto možností: RemoteUser StartTask Úkol |
CifsMountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
heslo | Heslo, které se má použít k ověřování v systému souborů CIFS. | string (povinné) |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
zdroj | Identifikátor URI systému souborů, který se má připojit. | string (povinné) |
uživatelské jméno | Uživatel, který se má použít k ověřování v systému souborů CIFS. | string (povinné) |
CloudServiceConfiguration
Jméno | Popis | Hodnota |
---|---|---|
osFamily | Možné hodnoty jsou: 2 – řada operačních systémů 2, která odpovídá systému Windows Server 2008 R2 SP1. 3– Řada operačních systémů 3, která odpovídá Systému Windows Server 2012. 4– Řada operačních systémů 4, která odpovídá Systému Windows Server 2012 R2. 5– Řada operačních systémů 5, která odpovídá Windows Serveru 2016. 6 – Řada operačních systémů 6, která odpovídá Windows Serveru 2019. Další informace najdete v tématu Vydání hostovaného operačního systému Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | string (povinné) |
osVersion | Výchozí hodnota je * určující nejnovější verzi operačního systému pro zadanou řadu operačních systémů. | řetězec |
ComputeNodeIdentityReference
Jméno | Popis | Hodnota |
---|---|---|
resourceId | ID prostředku ARM identity přiřazené uživatelem. | řetězec |
ContainerConfiguration
Jméno | Popis | Hodnota |
---|---|---|
containerImageNames | Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Image bude zdrojem z výchozího registru Dockeru, pokud není image plně kvalifikovaná s alternativním registrem. | string[] |
containerRegistries | Pokud se některé image musí stáhnout z privátního registru, který vyžaduje přihlašovací údaje, musí se tyto přihlašovací údaje zadat tady. | ContainerRegistry[] |
typ | Technologie kontejneru, která se má použít. | DockerCompatible (povinné) |
ContainerRegistry
Jméno | Popis | Hodnota |
---|---|---|
identityReference | Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. | ComputeNodeIdentityReference |
heslo | Heslo pro přihlášení k serveru registru. | řetězec |
registryServer | Pokud tuto hodnotu vynecháte, výchozí hodnota je docker.io. | řetězec |
uživatelské jméno | Uživatelské jméno pro přihlášení k serveru registru. | řetězec |
Datový disk
Jméno | Popis | Hodnota |
---|---|---|
ukrývání | Hodnoty jsou: none – Režim ukládání do mezipaměti disku není povolený. readOnly – režim ukládání do mezipaměti disku je jen pro čtení. readWrite – režim ukládání do mezipaměti disku je čtení a zápis. Výchozí hodnota pro ukládání do mezipaměti není žádná. Informace o možnostech ukládání do mezipaměti naleznete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
None (Žádný) ReadOnly ReadWrite |
diskSizeGB | Počáteční velikost disku v GB při vytváření nového datového disku. | int (povinné) |
Lun | Logická jednotka se používá k jedinečné identifikaci jednotlivých datových disků. Pokud připojujete více disků, každý by měl mít jinou logickou jednotku. Hodnota musí být v rozmezí od 0 do 63 včetně. | int (povinné) |
storageAccountType | Pokud tuto hodnotu vynecháte, výchozí hodnota je Standard_LRS. Hodnoty jsou: Standard_LRS – Datový disk by měl používat standardní místně redundantní úložiště. Premium_LRS – Datový disk by měl používat místně redundantní úložiště úrovně Premium. |
"Premium_LRS" "Standard_LRS" |
DeploymentConfiguration
Jméno | Popis | Hodnota |
---|---|---|
cloudServiceConfiguration | Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a je nutné zadat jednu z vlastností. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na UserSubscription. | CloudServiceConfiguration |
virtualMachineConfiguration | Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a je nutné zadat jednu z vlastností. | VirtualMachineConfiguration |
DiffDiskSettings
Jméno | Popis | Hodnota |
---|---|---|
umístění | Tuto vlastnost může uživatel v požadavku použít k výběru umístění, ve kterém má být operační systém. Například místo na disku mezipaměti pro dočasné zřizování disku s operačním systémem. Další informace o požadavcích na dočasné velikosti disku s operačním systémem najdete v dočasných požadavcích na velikost disku s operačním systémem pro virtuální počítače s Windows na adrese /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a virtuální počítače s Linuxem na adrese /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | CacheDisk |
DiskEncryptionConfiguration
Jméno | Popis | Hodnota |
---|---|---|
cíle | Ve fondu Linuxu se podporuje pouze dočasný disk. ve fondu Windows musí být zadány "OsDisk" a "TemporaryDisk". | Řetězcové pole obsahující některou z těchto možností: OsDisk Dočasný disk |
EnvironmentSetting
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název proměnné prostředí. | string (povinné) |
hodnota | Hodnota proměnné prostředí. | řetězec |
FixedScaleSettings
Jméno | Popis | Hodnota |
---|---|---|
nodeDeallocationOption | Pokud tuto hodnotu vynecháte, bude výchozí hodnota znovu uvedena v frontě. | 'Requeue' 'RetainedData' TaskCompletion Terminate (Ukončit) |
resizeTimeout | Výchozí hodnota je 15 minut. Hodnoty časového limitu používají formát ISO 8601. Například použijte PT10M po dobu 10 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch žádost odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek). | řetězec |
targetDedicatedNodes | Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven. | Int |
targetLowPriorityNodes | Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven. | Int |
ImageReference
Jméno | Popis | Hodnota |
---|---|---|
id | Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image Sdílené galerie imagí musí mít repliky ve stejné oblasti jako účet Azure Batch. Informace o nastavení brány firewall pro agenta uzlu Batch pro komunikaci se službou Batch najdete v tématu /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | řetězec |
nabídnout | Například UbuntuServer nebo WindowsServer. | řetězec |
vydavatel | Například Canonical nebo MicrosoftWindowsServer. | řetězec |
sku | Například 18.04-LTS nebo 2022-datacenter. | řetězec |
verze | Pokud chcete vybrat nejnovější verzi image, můžete zadat hodnotu "latest". Pokud tento parametr vynecháte, výchozí hodnota je nejnovější. | řetězec |
InboundNatPool
Jméno | Popis | Hodnota |
---|---|---|
backendPort | Musí to být jedinečné v rámci fondu batch. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 22, 3389, 29876 a 29877, protože jsou rezervované. Pokud jsou zadaná nějaká rezervovaná hodnota, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
frontendPortRangeEnd | Přijatelné hodnoty jsou v rozsahu 1 až 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny službou Batch. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
frontendPortRangeStart | Přijatelné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
Jméno | Název musí být jedinečný v rámci fondu Batch, může obsahovat písmena, číslice, podtržítka, tečky a pomlčky. Názvy musí začínat písmenem nebo číslicí, musí končit písmenem, číslem nebo podtržítkem a nesmí být delší než 77 znaků. Pokud jsou zadány neplatné hodnoty, požadavek selže se stavovým kódem HTTP 400. | string (povinné) |
networkSecurityGroupRules | Maximální počet pravidel, která je možné zadat ve všech koncových bodech ve fondu Batch, je 25. Pokud nejsou zadána žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k zadanému back-endportu. Pokud je překročen maximální počet pravidel skupiny zabezpečení sítě, požadavek selže se stavovým kódem HTTP 400. | NetworkSecurityGroupRule[] |
protokol | Protokol koncového bodu. | TCP UDP (povinné) |
LinuxUserConfiguration
Jméno | Popis | Hodnota |
---|---|---|
motoličnost | Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere gid. | Int |
sshPrivateKey | Privátní klíč nesmí být chráněný heslem. Privátní klíč se používá k automatické konfiguraci asymetrického ověřování založeného na klíči pro SSH mezi uzly ve fondu Linuxu, pokud je vlastnost enableInterNodeCommunication fondu true (je ignorována, pokud enableInterNodeCommunication je false). To provede umístěním páru klíčů do adresáře .ssh uživatele. Pokud není zadáno, není mezi uzly nakonfigurovaný protokol SSH bez hesla (není provedena žádná úprava adresáře .ssh uživatele). | řetězec |
Uid | Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere identifikátor uid. | Int |
MetadataItem
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název položky metadat. | string (povinné) |
hodnota | Hodnota položky metadat. | string (povinné) |
Microsoft.Batch/batchAccounts/pools
Jméno | Popis | Hodnota |
---|---|---|
identita | Typ identity, který se používá pro fond batch. | |
Jméno | Název prostředku | řetězec Omezení: Minimální délka = 1 Maximální délka = 64 Model = ^[a-zA-Z0-9_-]+$ (povinné) |
rodič | V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek. Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek. |
Symbolický název prostředku typu: batchAccounts |
vlastnosti | Vlastnosti přidružené k fondu. | |
MountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
azureBlobFileSystemConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | AzureBlobFileSystemConfiguration |
azureFileShareConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | azureFileShareConfiguration |
cifsMountConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | CifsMountConfiguration |
NfsMountConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | NFSMountConfiguration |
NetworkConfiguration
Jméno | Popis | Hodnota |
---|---|---|
dynamicVNetAssignmentScope | Rozsah dynamického přiřazení virtuální sítě. | 'job' 'none' |
endpointConfiguration | Konfigurace koncového bodu fondu je podporována pouze u fondů s vlastností virtualMachineConfiguration. | |
publicIPAddressConfiguration | Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration. | PublicIPAddressConfiguration |
subnetId | Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres pro přizpůsobení počtu uzlů ve fondu. Pokud podsíť nemá dostatek volných IP adres, fond částečně přidělí výpočetní uzly a dojde k chybě změny velikosti. Instanční objekt MicrosoftAzureBatch musí mít roli Přispěvatel klasických virtuálních počítačů Role-Based řízení přístupu (RBAC) pro zadanou virtuální síť. Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby mohla plánovat úkoly na výpočetních uzlech. To je možné ověřit kontrolou, jestli má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG). Pokud skupina zabezpečení sítě odepře komunikaci s výpočetními uzly v zadané podsíti, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Pokud má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci povoleno několik vyhrazených systémových portů. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 a port 22 pro Linux a port 3389 pro Windows. Pro fondy vytvořené s konfigurací cloudové služby povolte porty 10100, 20100 a 30100. Povolte také odchozí připojení ke službě Azure Storage na portu 443. U fondů cloudServiceConfiguration se podporují jenom klasické virtuální sítě. Další podrobnosti najdete v tématu: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | řetězec |
NetworkSecurityGroupRule
Jméno | Popis | Hodnota |
---|---|---|
přístup | Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku | Povolit Odepřít (povinné) |
priorita | Priority v rámci fondu musí být jedinečné a vyhodnocují se v pořadí podle priority. Čím nižší je číslo, tím vyšší je priorita. Můžete například zadat pravidla s čísly objednávek 150, 250 a 350. Pravidlo s číslem objednávky 150 má přednost před pravidlem, které má pořadí 250. Povolené priority jsou 150 až 4096. Pokud jsou zadány nějaké rezervované nebo duplicitní hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
sourceAddressPrefix | Platné hodnoty jsou jedna IP adresa (tj. 10.10.10.10.10), podsíť PROTOKOLU IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou zadány jakékoli jiné hodnoty, požadavek selže se stavovým kódem HTTP 400. | string (povinné) |
sourcePortRanges | Platné hodnoty jsou *(pro všechny porty 0 – 65535) nebo pole portů nebo rozsahů portů (tj. 100–200). Porty by měly být v rozsahu 0 až 65535 a rozsahy portů nebo porty se nesmí překrývat. Pokud jsou zadány jakékoli jiné hodnoty, požadavek selže se stavovým kódem HTTP 400. Výchozí hodnota bude *. | string[] |
NFSMountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
zdroj | Identifikátor URI systému souborů, který se má připojit. | string (povinné) |
NodePlacementConfiguration
Jméno | Popis | Hodnota |
---|---|---|
politika | Zásady přidělování, které služba Batch používá ke zřízení uzlů. Pokud není zadáno, služba Batch použije regionální politiku. | 'Oblast' 'Zónální' |
OSDisk
Jméno | Popis | Hodnota |
---|---|---|
Dočasné nastavení diskuOS | Určuje dočasné nastavení disku pro disk operačního systému používaný virtuálním počítačem. | |
PoolEndpointConfiguration
PoolProperties
Jméno | Popis | Hodnota |
---|---|---|
applicationLicenses | Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud se požaduje licence, která se nepodporuje, vytvoření fondu se nezdaří. | string[] |
applicationPackages | Změny odkazů na balíčky aplikací ovlivňují všechny nové výpočetní uzly připojující se k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nezomagí. V jakémkoli fondu je maximálně 10 odkazů na balíčky aplikací. | ApplicationPackageReference[] |
certifikáty | Pro výpočetní uzly Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři. | CertificateReference[] |
deploymentConfiguration | Použití CloudServiceConfiguration určuje, že uzly by měly být vytvářeny pomocí Azure Cloud Services (PaaS), zatímco VirtualMachineConfiguration používá Azure Virtual Machines (IaaS). | DeploymentConfiguration |
displayName | Zobrazovaný název nemusí být jedinečný a může obsahovat libovolné znaky Unicode až do maximální délky 1024. | řetězec |
interNodeCommunication | To platí pro omezení, ke kterým uzlům je možné přiřadit fond. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadána, tato hodnota je ve výchozím nastavení zakázaná. | Zakázáno Povoleno |
metadata | Služba Batch nepřiřazuje metadatům žádný význam; je výhradně pro použití uživatelského kódu. | metadataItem[] |
mountConfiguration | To podporuje Soubory Azure, NFS, CIFS/SMB a Blobfuse. | MountConfiguration[] |
networkConfiguration | Konfigurace sítě pro fond. | |
scaleSettings | Definuje požadovanou velikost fondu. Může to být buď fixedScale, kde je zadán požadovaný cílovýDedicatedNodes, nebo "autoScale", který definuje vzorec, který se pravidelně znovu vyhodnocuje. Pokud tato vlastnost není zadána, bude mít fond pevné škálování s 0 targetDedicatedNodes. | |
startTask | V operaci PATCH (update) lze tuto vlastnost nastavit na prázdný objekt, který odebere spouštěcí úlohu z fondu. | StartTask |
taskSchedulingPolicy | Pokud není zadáno, výchozí hodnota se rozloží. | TaskSchedulingPolicy |
taskSlotsPerNode | Výchozí hodnota je 1. Maximální hodnota je menší 4krát počet jader vmSize fondu nebo 256. | Int |
userAccounts | Seznam uživatelských účtů, které se mají vytvořit na každém uzlu ve fondu. | UserAccount[] |
vmSize | Informace o dostupných velikostech virtuálních počítačů pro fondy cloudových služeb (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro cloudové služby (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall. Informace o dostupných velikostech virtuálních počítačů pro fondy používající image z Marketplace virtuálních počítačů (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti virtuálních počítačů (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti virtuálních počítačů (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a těch, které mají službu Premium Storage (STANDARD_GS, STANDARD_DS a STANDARD_DSV2 series). | řetězec |
PublicIPAddressConfiguration
Jméno | Popis | Hodnota |
---|---|---|
ipAddressIds | Počet ZDE zadaných IP adres omezuje maximální velikost fondu – 100 vyhrazených uzlů nebo 100 uzlů s spotovou/nízkou prioritou je možné přidělit pro každou veřejnou IP adresu. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, by potřeboval alespoň 3 veřejné IP adresy zadané. Každý prvek této kolekce má tvar: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
poskytnutí | Výchozí hodnota je BatchManaged. | BatchManaged NoPublicIPAddresses UserManaged |
ResourceFile
Jméno | Popis | Hodnota |
---|---|---|
autoStorageContainerName | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. | řetězec |
blobPrefix | Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečným názvem souboru nebo podadresářem. Pokud předpona není zadaná, stáhnou se všechny soubory v kontejneru. | řetězec |
fileMode | Tato vlastnost se vztahuje pouze na soubory, které se stahují do výpočetních uzlů Linuxu. Bude ignorován, pokud je zadán pro resourceFile, který se stáhne do uzlu Windows. Pokud tato vlastnost není určena pro uzel Linuxu, použije se na soubor výchozí hodnota 0770. | řetězec |
filePath | Pokud je zadána vlastnost httpUrl, je souborPath vyžadován a popisuje cestu, do které se soubor stáhne, včetně názvu souboru. Jinak je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů. V případě, že se filePath používá jako adresář, všechny adresářové struktury, které jsou již přidruženy ke vstupním datům, se zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže přerušit pracovní adresář úkolu (například pomocí ..). | řetězec |
httpUrl | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL objektu blob v úložišti Azure: zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použít spravovanou identitu s oprávněním ke čtení nebo nastavit seznam ACL objektu blob nebo jeho kontejneru tak, aby umožňoval veřejný přístup. | řetězec |
identityReference | Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. | ComputeNodeIdentityReference |
storageContainerUrl | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Tato adresa URL musí být čitelná a vypisovatelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL kontejneru v úložišti Azure: zahrnutí sdíleného přístupového podpisu (SAS) udělujícího oprávnění ke čtení a seznamu v kontejneru, použití spravované identity s oprávněními ke čtení a seznamu nebo nastavení seznamu ACL pro kontejner tak, aby umožňoval veřejný přístup. | řetězec |
ScaleSettings
StartTask
Jméno | Popis | Hodnota |
---|---|---|
commandLine | Příkazový řádek se nespustí pod prostředím, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí na příkazovém řádku, například pomocí příkazu cmd /c MyCommand ve Windows nebo /bin/sh -c MyCommand v Linuxu. Vyžaduje se, pokud jsou zadány jakékoli další vlastnosti startTask. | řetězec |
containerSettings | Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen adresářů Azure Batch na uzlu) mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru. | TaskContainerSettings |
environmentSettings | Seznam nastavení proměnných prostředí pro spouštěcí úlohu. | EnvironmentSetting[] |
maxTaskRetryCount | Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování). | Int |
resourceFiles | Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. | ResourceFile[] |
userIdentity | Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úkol jedinečný. | userIdentity |
waitForSuccess | Pokud hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje spouštěcí úlohu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o plánování chyb. Pokud je false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V tomto případě můžou na výpočetním uzlu začít spouštět jiné úkoly, zatímco spouštěcí úkol je stále spuštěný; i v případě, že spouštěcí úkol selže, budou na uzlu i nadále naplánované nové úkoly. Výchozí hodnota je true. | Bool |
TaskContainerSettings
Jméno | Popis | Hodnota |
---|---|---|
containerRunOptions | Tyto další možnosti se předávají jako argumenty příkazu "docker create" kromě těch, které řídí služba Batch. | řetězec |
imageName | Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Pokud v názvu image není k dispozici žádná značka, použije se jako výchozí značka :latest. | string (povinné) |
registr | Toto nastavení je možné vynechat, pokud již bylo k dispozici při vytváření fondu. | ContainerRegistry |
workingDirectory | Příznak označující, kde je pracovní adresář úloh kontejneru. Výchozí hodnota je taskWorkingDirectory. | ContainerImageDefault TaskWorkingDirectory |
TaskSchedulingPolicy
Jméno | Popis | Hodnota |
---|---|---|
nodeFillType | Jak se mají úkoly distribuovat napříč výpočetními uzly. | Balíček "Rozprostřený" (povinné) |
UserAccount
Jméno | Popis | Hodnota |
---|---|---|
elevationLevel | nonAdmin – Automatický uživatel je standardní uživatel bez zvýšeného přístupu. admin – Automatický uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce. Výchozí hodnota neníadmin. | Správce NonAdmin |
linuxUserConfiguration | Tato vlastnost se ignoruje, pokud je zadána ve fondu Windows. Pokud není zadaný, uživatel se vytvoří s výchozími možnostmi. | LinuxUserConfiguration |
Jméno | Název uživatelského účtu. | string (povinné) |
heslo | Heslo pro uživatelský účet. | string (povinné) |
windowsUserConfiguration | Tuto vlastnost lze zadat pouze v případě, že je uživatel ve fondu Windows. Pokud není zadaný a ve fondu Windows, vytvoří se uživatel s výchozími možnostmi. | WindowsUserConfiguration |
UserAssignedIdentities
Jméno | Popis | Hodnota |
---|
UserIdentity
VirtualMachineConfiguration
Jméno | Popis | Hodnota |
---|---|---|
containerConfiguration | Pokud je zadáno, provede se nastavení na každém uzlu ve fondu, aby se úlohy mohly spouštět v kontejnerech. Všechny běžné úlohy a úlohy správce úloh spuštěné v tomto fondu musí určovat vlastnost containerSettings a všechny ostatní úkoly ho mohou určit. | ContainerConfiguration |
dataDisks | Tato vlastnost musí být zadána, pokud výpočetní uzly ve fondu musí mít připojené prázdné datové disky. | DataDisk[] |
diskEncryptionConfiguration | Pokud je zadáno, šifrování se provádí na každém uzlu ve fondu během zřizování uzlů. | DiskEncryptionConfiguration |
rozšíření | V případě zadání se rozšíření uvedená v této konfiguraci nainstalují na každý uzel. | VMExtension[] |
imageReference | Odkaz na image Azure Virtual Machines Marketplace nebo prostředek image Azure vlastního virtuálního počítače. Pokud chcete získat seznam všech imagí Ověřených službou Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu. | imageReference (povinné) |
licenseType | Týká se to jenom imagí, které obsahují operační systém Windows, a měly by se používat jenom v případě, že pro uzly, které budou nasazeny, uchovávat platné místní licence. Pokud tento parametr vynecháte, nepoužije se žádná sleva za místní licencování. Hodnoty jsou: Windows_Server – místní licence je určená pro Windows Server. Windows_Client – místní licence je určená pro klienta Windows. |
řetězec |
nodeAgentSkuId | Agent uzlu Batch je program, který běží na každém uzlu ve fondu a poskytuje rozhraní příkazového a řídicího rozhraní mezi uzlem a službou Batch. Existují různé implementace agenta uzlu, označovaného jako SKU, pro různé operační systémy. Musíte zadat skladovou položku agenta uzlu, která odpovídá vybranému odkazu na image. Pokud chcete získat seznam podporovaných skladových položek agenta uzlu spolu s jejich seznamem ověřených odkazů na image, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu. | string (povinné) |
nodePlacementConfiguration | Tato konfigurace určuje pravidla, jak budou uzly ve fondu fyzicky přiděleny. | NodePlacementConfiguration |
osDisk | Obsahuje konfiguraci pro dočasné nastavení disku OSDisk. | disku |
WindowsConfiguration | Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux. | WindowsConfiguration |
VMExtension
Jméno | Popis | Hodnota |
---|---|---|
autoUpgradeMinorVersion | Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true. | Bool |
Jméno | Název rozšíření virtuálního počítače | string (povinné) |
protectedSettings | Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení. | jakýkoliv |
provisionAfterExtensions | Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit. | string[] |
vydavatel | Název vydavatele obslužné rutiny rozšíření. | string (povinné) |
nastavení | Veřejná nastavení ve formátu JSON pro rozšíření | jakýkoliv |
typ | Typ rozšíření. | string (povinné) |
typeHandlerVersion | Verze obslužné rutiny skriptu. | řetězec |
WindowsConfiguration
Jméno | Popis | Hodnota |
---|---|---|
enableAutomaticUpdates | Pokud tuto hodnotu vynecháte, výchozí hodnota je true. | Bool |
WindowsUserConfiguration
Jméno | Popis | Hodnota |
---|---|---|
loginMode | Určuje režim přihlášení pro uživatele. Výchozí hodnota pro fondy VirtualMachineConfiguration je interaktivní režim a pro fondy CloudServiceConfiguration je dávkový režim. | Batch Interaktivní |
Ukázky rychlého startu
Následující ukázky rychlého startu nasadí tento typ prostředku.
Soubor Bicep | Popis |
---|---|
fond Služby Azure Batch bez veřejných IP adres | Tato šablona vytvoří zjednodušený fond komunikace uzlů služby Azure Batch bez veřejných IP adres. |
Definice prostředku šablony ARM
Typ prostředku batchAccounts/pools je možné nasadit s operacemi, které cílí:
- skupiny prostředků – viz příkazy nasazení skupiny prostředků
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Formát prostředku
Pokud chcete vytvořit prostředek Microsoft.Batch/batchAccounts/pools, přidejte do šablony následující KÓD JSON.
{
"type": "Microsoft.Batch/batchAccounts/pools",
"apiVersion": "2022-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": [
{
"identityReference": {
"resourceId": "string"
},
"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"
},
"osDisk": {
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
}
},
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountKey": "string",
"accountName": "string",
"blobfuseOptions": "string",
"containerName": "string",
"identityReference": {
"resourceId": "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": {
"dynamicVNetAssignmentScope": "string",
"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": {
"identityReference": {
"resourceId": "string"
},
"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",
"identityReference": {
"resourceId": "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"
}
}
Hodnoty vlastností
ApplicationPackageReference
Jméno | Popis | Hodnota |
---|---|---|
id | ID balíčku aplikace, který se má nainstalovat. Musí se nacházet ve stejném účtu Batch jako fond. Může se jednat o odkaz na konkrétní verzi nebo výchozí verzi, pokud existuje. | string (povinné) |
verze | Pokud tuto hodnotu vynecháte a pro tuto aplikaci není zadána žádná výchozí verze, požadavek selže s kódem chyby InvalidApplicationPackageReferences. Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409. | řetězec |
Automatické škálováníSettings
Jméno | Popis | Hodnota |
---|---|---|
evaluationInterval | Pokud tuto hodnotu vynecháte, výchozí hodnota je 15 minut (PT15M). | řetězec |
vzorec | Vzorec pro požadovaný počet výpočetních uzlů ve fondu | string (povinné) |
AutoUserSpecification
Jméno | Popis | Hodnota |
---|---|---|
elevationLevel | Výchozí hodnota neníadmin. | Správce NonAdmin |
rozsah | Výchozí hodnota je Pool. Pokud fond používá Systém Windows, měla by být zadána hodnota Úlohy, pokud je vyžadována přísnější izolace mezi úlohami. Pokud například úloha ztlumí registr způsobem, který by mohl ovlivnit jiné úkoly, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné běžnými úkoly, ale měly by být přístupné podle počátečních úkolů. | "Bazén" Úkol |
AzureBlobFileSystemConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Tato vlastnost se vzájemně vylučují s sasKey i identitou; musí být zadána přesně jedna. | řetězec |
accountName | Název účtu úložiště Azure. | string (povinné) |
blobfuseOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
containerName | Název kontejneru služby Azure Blob Storage. | string (povinné) |
identityReference | Tato vlastnost se vzájemně vylučují s accountKey i sasKey; musí být zadána přesně jedna. | ComputeNodeIdentityReference |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
sasKey | Tato vlastnost se vzájemně vylučují s accountKey i identitou; musí být zadána přesně jedna. | řetězec |
AzureFileShareConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Klíč účtu služby Azure Storage. | string (povinné) |
accountName | Název účtu služby Azure Storage. | string (povinné) |
azureFileUrl | Toto je formulář "https://{account}.file.core.windows.net/". | string (povinné) |
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
BatchPoolIdentity
Jméno | Popis | Hodnota |
---|---|---|
typ | Typ identity, který se používá pro fond batch. | None (Žádný) UserAssigned (povinné) |
userAssignedIdentities | Seznam identit uživatelů přidružených k fondu Batch. | batchPoolIdentityUserAssignedIdentities |
BatchPoolIdentityUserAssignedIdentities
Jméno | Popis | Hodnota |
---|
CertificateReference
Jméno | Popis | Hodnota |
---|---|---|
id | Plně kvalifikované ID certifikátu, které se má nainstalovat do fondu. Musí se nacházet ve stejném účtu Batch jako fond. | string (povinné) |
storeLocation | Výchozí hodnota je currentUser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že je vytvořená pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři. | CurrentUser LocalMachine |
storeName | Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že je vytvořená pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale můžete také použít jakýkoli vlastní název úložiště. Výchozí hodnota je My. | řetězec |
viditelnost | Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu. | Řetězcové pole obsahující některou z těchto možností: RemoteUser StartTask Úkol |
CifsMountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
heslo | Heslo, které se má použít k ověřování v systému souborů CIFS. | string (povinné) |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
zdroj | Identifikátor URI systému souborů, který se má připojit. | string (povinné) |
uživatelské jméno | Uživatel, který se má použít k ověřování v systému souborů CIFS. | string (povinné) |
CloudServiceConfiguration
Jméno | Popis | Hodnota |
---|---|---|
osFamily | Možné hodnoty jsou: 2 – řada operačních systémů 2, která odpovídá systému Windows Server 2008 R2 SP1. 3– Řada operačních systémů 3, která odpovídá Systému Windows Server 2012. 4– Řada operačních systémů 4, která odpovídá Systému Windows Server 2012 R2. 5– Řada operačních systémů 5, která odpovídá Windows Serveru 2016. 6 – Řada operačních systémů 6, která odpovídá Windows Serveru 2019. Další informace najdete v tématu Vydání hostovaného operačního systému Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | string (povinné) |
osVersion | Výchozí hodnota je * určující nejnovější verzi operačního systému pro zadanou řadu operačních systémů. | řetězec |
ComputeNodeIdentityReference
Jméno | Popis | Hodnota |
---|---|---|
resourceId | ID prostředku ARM identity přiřazené uživatelem. | řetězec |
ContainerConfiguration
Jméno | Popis | Hodnota |
---|---|---|
containerImageNames | Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Image bude zdrojem z výchozího registru Dockeru, pokud není image plně kvalifikovaná s alternativním registrem. | string[] |
containerRegistries | Pokud se některé image musí stáhnout z privátního registru, který vyžaduje přihlašovací údaje, musí se tyto přihlašovací údaje zadat tady. | ContainerRegistry[] |
typ | Technologie kontejneru, která se má použít. | DockerCompatible (povinné) |
ContainerRegistry
Jméno | Popis | Hodnota |
---|---|---|
identityReference | Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. | ComputeNodeIdentityReference |
heslo | Heslo pro přihlášení k serveru registru. | řetězec |
registryServer | Pokud tuto hodnotu vynecháte, výchozí hodnota je docker.io. | řetězec |
uživatelské jméno | Uživatelské jméno pro přihlášení k serveru registru. | řetězec |
Datový disk
Jméno | Popis | Hodnota |
---|---|---|
ukrývání | Hodnoty jsou: none – Režim ukládání do mezipaměti disku není povolený. readOnly – režim ukládání do mezipaměti disku je jen pro čtení. readWrite – režim ukládání do mezipaměti disku je čtení a zápis. Výchozí hodnota pro ukládání do mezipaměti není žádná. Informace o možnostech ukládání do mezipaměti naleznete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
None (Žádný) ReadOnly ReadWrite |
diskSizeGB | Počáteční velikost disku v GB při vytváření nového datového disku. | int (povinné) |
Lun | Logická jednotka se používá k jedinečné identifikaci jednotlivých datových disků. Pokud připojujete více disků, každý by měl mít jinou logickou jednotku. Hodnota musí být v rozmezí od 0 do 63 včetně. | int (povinné) |
storageAccountType | Pokud tuto hodnotu vynecháte, výchozí hodnota je Standard_LRS. Hodnoty jsou: Standard_LRS – Datový disk by měl používat standardní místně redundantní úložiště. Premium_LRS – Datový disk by měl používat místně redundantní úložiště úrovně Premium. |
"Premium_LRS" "Standard_LRS" |
DeploymentConfiguration
Jméno | Popis | Hodnota |
---|---|---|
cloudServiceConfiguration | Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a je nutné zadat jednu z vlastností. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na UserSubscription. | CloudServiceConfiguration |
virtualMachineConfiguration | Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a je nutné zadat jednu z vlastností. | VirtualMachineConfiguration |
DiffDiskSettings
Jméno | Popis | Hodnota |
---|---|---|
umístění | Tuto vlastnost může uživatel v požadavku použít k výběru umístění, ve kterém má být operační systém. Například místo na disku mezipaměti pro dočasné zřizování disku s operačním systémem. Další informace o požadavcích na dočasné velikosti disku s operačním systémem najdete v dočasných požadavcích na velikost disku s operačním systémem pro virtuální počítače s Windows na adrese /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a virtuální počítače s Linuxem na adrese /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | CacheDisk |
DiskEncryptionConfiguration
Jméno | Popis | Hodnota |
---|---|---|
cíle | Ve fondu Linuxu se podporuje pouze dočasný disk. ve fondu Windows musí být zadány "OsDisk" a "TemporaryDisk". | Řetězcové pole obsahující některou z těchto možností: OsDisk Dočasný disk |
EnvironmentSetting
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název proměnné prostředí. | string (povinné) |
hodnota | Hodnota proměnné prostředí. | řetězec |
FixedScaleSettings
Jméno | Popis | Hodnota |
---|---|---|
nodeDeallocationOption | Pokud tuto hodnotu vynecháte, bude výchozí hodnota znovu uvedena v frontě. | 'Requeue' 'RetainedData' TaskCompletion Terminate (Ukončit) |
resizeTimeout | Výchozí hodnota je 15 minut. Hodnoty časového limitu používají formát ISO 8601. Například použijte PT10M po dobu 10 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch žádost odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek). | řetězec |
targetDedicatedNodes | Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven. | Int |
targetLowPriorityNodes | Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven. | Int |
ImageReference
Jméno | Popis | Hodnota |
---|---|---|
id | Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image Sdílené galerie imagí musí mít repliky ve stejné oblasti jako účet Azure Batch. Informace o nastavení brány firewall pro agenta uzlu Batch pro komunikaci se službou Batch najdete v tématu /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | řetězec |
nabídnout | Například UbuntuServer nebo WindowsServer. | řetězec |
vydavatel | Například Canonical nebo MicrosoftWindowsServer. | řetězec |
sku | Například 18.04-LTS nebo 2022-datacenter. | řetězec |
verze | Pokud chcete vybrat nejnovější verzi image, můžete zadat hodnotu "latest". Pokud tento parametr vynecháte, výchozí hodnota je nejnovější. | řetězec |
InboundNatPool
Jméno | Popis | Hodnota |
---|---|---|
backendPort | Musí to být jedinečné v rámci fondu batch. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 22, 3389, 29876 a 29877, protože jsou rezervované. Pokud jsou zadaná nějaká rezervovaná hodnota, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
frontendPortRangeEnd | Přijatelné hodnoty jsou v rozsahu 1 až 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny službou Batch. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
frontendPortRangeStart | Přijatelné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
Jméno | Název musí být jedinečný v rámci fondu Batch, může obsahovat písmena, číslice, podtržítka, tečky a pomlčky. Názvy musí začínat písmenem nebo číslicí, musí končit písmenem, číslem nebo podtržítkem a nesmí být delší než 77 znaků. Pokud jsou zadány neplatné hodnoty, požadavek selže se stavovým kódem HTTP 400. | string (povinné) |
networkSecurityGroupRules | Maximální počet pravidel, která je možné zadat ve všech koncových bodech ve fondu Batch, je 25. Pokud nejsou zadána žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k zadanému back-endportu. Pokud je překročen maximální počet pravidel skupiny zabezpečení sítě, požadavek selže se stavovým kódem HTTP 400. | NetworkSecurityGroupRule[] |
protokol | Protokol koncového bodu. | TCP UDP (povinné) |
LinuxUserConfiguration
Jméno | Popis | Hodnota |
---|---|---|
motoličnost | Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere gid. | Int |
sshPrivateKey | Privátní klíč nesmí být chráněný heslem. Privátní klíč se používá k automatické konfiguraci asymetrického ověřování založeného na klíči pro SSH mezi uzly ve fondu Linuxu, pokud je vlastnost enableInterNodeCommunication fondu true (je ignorována, pokud enableInterNodeCommunication je false). To provede umístěním páru klíčů do adresáře .ssh uživatele. Pokud není zadáno, není mezi uzly nakonfigurovaný protokol SSH bez hesla (není provedena žádná úprava adresáře .ssh uživatele). | řetězec |
Uid | Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere identifikátor uid. | Int |
MetadataItem
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název položky metadat. | string (povinné) |
hodnota | Hodnota položky metadat. | string (povinné) |
Microsoft.Batch/batchAccounts/pools
Jméno | Popis | Hodnota |
---|---|---|
apiVersion | Verze rozhraní API | '2022-01-01' |
identita | Typ identity, který se používá pro fond batch. | |
Jméno | Název prostředku | řetězec Omezení: Minimální délka = 1 Maximální délka = 64 Model = ^[a-zA-Z0-9_-]+$ (povinné) |
vlastnosti | Vlastnosti přidružené k fondu. | |
typ | Typ prostředku | Microsoft.Batch/batchAccounts/pools |
MountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
azureBlobFileSystemConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | AzureBlobFileSystemConfiguration |
azureFileShareConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | azureFileShareConfiguration |
cifsMountConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | CifsMountConfiguration |
NfsMountConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | NFSMountConfiguration |
NetworkConfiguration
Jméno | Popis | Hodnota |
---|---|---|
dynamicVNetAssignmentScope | Rozsah dynamického přiřazení virtuální sítě. | 'job' 'none' |
endpointConfiguration | Konfigurace koncového bodu fondu je podporována pouze u fondů s vlastností virtualMachineConfiguration. | |
publicIPAddressConfiguration | Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration. | PublicIPAddressConfiguration |
subnetId | Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres pro přizpůsobení počtu uzlů ve fondu. Pokud podsíť nemá dostatek volných IP adres, fond částečně přidělí výpočetní uzly a dojde k chybě změny velikosti. Instanční objekt MicrosoftAzureBatch musí mít roli Přispěvatel klasických virtuálních počítačů Role-Based řízení přístupu (RBAC) pro zadanou virtuální síť. Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby mohla plánovat úkoly na výpočetních uzlech. To je možné ověřit kontrolou, jestli má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG). Pokud skupina zabezpečení sítě odepře komunikaci s výpočetními uzly v zadané podsíti, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Pokud má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci povoleno několik vyhrazených systémových portů. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 a port 22 pro Linux a port 3389 pro Windows. Pro fondy vytvořené s konfigurací cloudové služby povolte porty 10100, 20100 a 30100. Povolte také odchozí připojení ke službě Azure Storage na portu 443. U fondů cloudServiceConfiguration se podporují jenom klasické virtuální sítě. Další podrobnosti najdete v tématu: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | řetězec |
NetworkSecurityGroupRule
Jméno | Popis | Hodnota |
---|---|---|
přístup | Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku | Povolit Odepřít (povinné) |
priorita | Priority v rámci fondu musí být jedinečné a vyhodnocují se v pořadí podle priority. Čím nižší je číslo, tím vyšší je priorita. Můžete například zadat pravidla s čísly objednávek 150, 250 a 350. Pravidlo s číslem objednávky 150 má přednost před pravidlem, které má pořadí 250. Povolené priority jsou 150 až 4096. Pokud jsou zadány nějaké rezervované nebo duplicitní hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
sourceAddressPrefix | Platné hodnoty jsou jedna IP adresa (tj. 10.10.10.10.10), podsíť PROTOKOLU IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou zadány jakékoli jiné hodnoty, požadavek selže se stavovým kódem HTTP 400. | string (povinné) |
sourcePortRanges | Platné hodnoty jsou *(pro všechny porty 0 – 65535) nebo pole portů nebo rozsahů portů (tj. 100–200). Porty by měly být v rozsahu 0 až 65535 a rozsahy portů nebo porty se nesmí překrývat. Pokud jsou zadány jakékoli jiné hodnoty, požadavek selže se stavovým kódem HTTP 400. Výchozí hodnota bude *. | string[] |
NFSMountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
zdroj | Identifikátor URI systému souborů, který se má připojit. | string (povinné) |
NodePlacementConfiguration
Jméno | Popis | Hodnota |
---|---|---|
politika | Zásady přidělování, které služba Batch používá ke zřízení uzlů. Pokud není zadáno, služba Batch použije regionální politiku. | 'Oblast' 'Zónální' |
OSDisk
Jméno | Popis | Hodnota |
---|---|---|
Dočasné nastavení diskuOS | Určuje dočasné nastavení disku pro disk operačního systému používaný virtuálním počítačem. | |
PoolEndpointConfiguration
PoolProperties
Jméno | Popis | Hodnota |
---|---|---|
applicationLicenses | Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud se požaduje licence, která se nepodporuje, vytvoření fondu se nezdaří. | string[] |
applicationPackages | Změny odkazů na balíčky aplikací ovlivňují všechny nové výpočetní uzly připojující se k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nezomagí. V jakémkoli fondu je maximálně 10 odkazů na balíčky aplikací. | ApplicationPackageReference[] |
certifikáty | Pro výpočetní uzly Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři. | CertificateReference[] |
deploymentConfiguration | Použití CloudServiceConfiguration určuje, že uzly by měly být vytvářeny pomocí Azure Cloud Services (PaaS), zatímco VirtualMachineConfiguration používá Azure Virtual Machines (IaaS). | DeploymentConfiguration |
displayName | Zobrazovaný název nemusí být jedinečný a může obsahovat libovolné znaky Unicode až do maximální délky 1024. | řetězec |
interNodeCommunication | To platí pro omezení, ke kterým uzlům je možné přiřadit fond. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadána, tato hodnota je ve výchozím nastavení zakázaná. | Zakázáno Povoleno |
metadata | Služba Batch nepřiřazuje metadatům žádný význam; je výhradně pro použití uživatelského kódu. | metadataItem[] |
mountConfiguration | To podporuje Soubory Azure, NFS, CIFS/SMB a Blobfuse. | MountConfiguration[] |
networkConfiguration | Konfigurace sítě pro fond. | |
scaleSettings | Definuje požadovanou velikost fondu. Může to být buď fixedScale, kde je zadán požadovaný cílovýDedicatedNodes, nebo "autoScale", který definuje vzorec, který se pravidelně znovu vyhodnocuje. Pokud tato vlastnost není zadána, bude mít fond pevné škálování s 0 targetDedicatedNodes. | |
startTask | V operaci PATCH (update) lze tuto vlastnost nastavit na prázdný objekt, který odebere spouštěcí úlohu z fondu. | StartTask |
taskSchedulingPolicy | Pokud není zadáno, výchozí hodnota se rozloží. | TaskSchedulingPolicy |
taskSlotsPerNode | Výchozí hodnota je 1. Maximální hodnota je menší 4krát počet jader vmSize fondu nebo 256. | Int |
userAccounts | Seznam uživatelských účtů, které se mají vytvořit na každém uzlu ve fondu. | UserAccount[] |
vmSize | Informace o dostupných velikostech virtuálních počítačů pro fondy cloudových služeb (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro cloudové služby (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall. Informace o dostupných velikostech virtuálních počítačů pro fondy používající image z Marketplace virtuálních počítačů (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti virtuálních počítačů (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti virtuálních počítačů (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a těch, které mají službu Premium Storage (STANDARD_GS, STANDARD_DS a STANDARD_DSV2 series). | řetězec |
PublicIPAddressConfiguration
Jméno | Popis | Hodnota |
---|---|---|
ipAddressIds | Počet ZDE zadaných IP adres omezuje maximální velikost fondu – 100 vyhrazených uzlů nebo 100 uzlů s spotovou/nízkou prioritou je možné přidělit pro každou veřejnou IP adresu. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, by potřeboval alespoň 3 veřejné IP adresy zadané. Každý prvek této kolekce má tvar: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
poskytnutí | Výchozí hodnota je BatchManaged. | BatchManaged NoPublicIPAddresses UserManaged |
ResourceFile
Jméno | Popis | Hodnota |
---|---|---|
autoStorageContainerName | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. | řetězec |
blobPrefix | Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečným názvem souboru nebo podadresářem. Pokud předpona není zadaná, stáhnou se všechny soubory v kontejneru. | řetězec |
fileMode | Tato vlastnost se vztahuje pouze na soubory, které se stahují do výpočetních uzlů Linuxu. Bude ignorován, pokud je zadán pro resourceFile, který se stáhne do uzlu Windows. Pokud tato vlastnost není určena pro uzel Linuxu, použije se na soubor výchozí hodnota 0770. | řetězec |
filePath | Pokud je zadána vlastnost httpUrl, je souborPath vyžadován a popisuje cestu, do které se soubor stáhne, včetně názvu souboru. Jinak je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů. V případě, že se filePath používá jako adresář, všechny adresářové struktury, které jsou již přidruženy ke vstupním datům, se zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže přerušit pracovní adresář úkolu (například pomocí ..). | řetězec |
httpUrl | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL objektu blob v úložišti Azure: zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použít spravovanou identitu s oprávněním ke čtení nebo nastavit seznam ACL objektu blob nebo jeho kontejneru tak, aby umožňoval veřejný přístup. | řetězec |
identityReference | Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. | ComputeNodeIdentityReference |
storageContainerUrl | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Tato adresa URL musí být čitelná a vypisovatelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL kontejneru v úložišti Azure: zahrnutí sdíleného přístupového podpisu (SAS) udělujícího oprávnění ke čtení a seznamu v kontejneru, použití spravované identity s oprávněními ke čtení a seznamu nebo nastavení seznamu ACL pro kontejner tak, aby umožňoval veřejný přístup. | řetězec |
ScaleSettings
StartTask
Jméno | Popis | Hodnota |
---|---|---|
commandLine | Příkazový řádek se nespustí pod prostředím, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí na příkazovém řádku, například pomocí příkazu cmd /c MyCommand ve Windows nebo /bin/sh -c MyCommand v Linuxu. Vyžaduje se, pokud jsou zadány jakékoli další vlastnosti startTask. | řetězec |
containerSettings | Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen adresářů Azure Batch na uzlu) mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru. | TaskContainerSettings |
environmentSettings | Seznam nastavení proměnných prostředí pro spouštěcí úlohu. | EnvironmentSetting[] |
maxTaskRetryCount | Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování). | Int |
resourceFiles | Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. | ResourceFile[] |
userIdentity | Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úkol jedinečný. | userIdentity |
waitForSuccess | Pokud hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje spouštěcí úlohu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o plánování chyb. Pokud je false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V tomto případě můžou na výpočetním uzlu začít spouštět jiné úkoly, zatímco spouštěcí úkol je stále spuštěný; i v případě, že spouštěcí úkol selže, budou na uzlu i nadále naplánované nové úkoly. Výchozí hodnota je true. | Bool |
TaskContainerSettings
Jméno | Popis | Hodnota |
---|---|---|
containerRunOptions | Tyto další možnosti se předávají jako argumenty příkazu "docker create" kromě těch, které řídí služba Batch. | řetězec |
imageName | Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Pokud v názvu image není k dispozici žádná značka, použije se jako výchozí značka :latest. | string (povinné) |
registr | Toto nastavení je možné vynechat, pokud již bylo k dispozici při vytváření fondu. | ContainerRegistry |
workingDirectory | Příznak označující, kde je pracovní adresář úloh kontejneru. Výchozí hodnota je taskWorkingDirectory. | ContainerImageDefault TaskWorkingDirectory |
TaskSchedulingPolicy
Jméno | Popis | Hodnota |
---|---|---|
nodeFillType | Jak se mají úkoly distribuovat napříč výpočetními uzly. | Balíček "Rozprostřený" (povinné) |
UserAccount
Jméno | Popis | Hodnota |
---|---|---|
elevationLevel | nonAdmin – Automatický uživatel je standardní uživatel bez zvýšeného přístupu. admin – Automatický uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce. Výchozí hodnota neníadmin. | Správce NonAdmin |
linuxUserConfiguration | Tato vlastnost se ignoruje, pokud je zadána ve fondu Windows. Pokud není zadaný, uživatel se vytvoří s výchozími možnostmi. | LinuxUserConfiguration |
Jméno | Název uživatelského účtu. | string (povinné) |
heslo | Heslo pro uživatelský účet. | string (povinné) |
windowsUserConfiguration | Tuto vlastnost lze zadat pouze v případě, že je uživatel ve fondu Windows. Pokud není zadaný a ve fondu Windows, vytvoří se uživatel s výchozími možnostmi. | WindowsUserConfiguration |
UserAssignedIdentities
Jméno | Popis | Hodnota |
---|
UserIdentity
VirtualMachineConfiguration
Jméno | Popis | Hodnota |
---|---|---|
containerConfiguration | Pokud je zadáno, provede se nastavení na každém uzlu ve fondu, aby se úlohy mohly spouštět v kontejnerech. Všechny běžné úlohy a úlohy správce úloh spuštěné v tomto fondu musí určovat vlastnost containerSettings a všechny ostatní úkoly ho mohou určit. | ContainerConfiguration |
dataDisks | Tato vlastnost musí být zadána, pokud výpočetní uzly ve fondu musí mít připojené prázdné datové disky. | DataDisk[] |
diskEncryptionConfiguration | Pokud je zadáno, šifrování se provádí na každém uzlu ve fondu během zřizování uzlů. | DiskEncryptionConfiguration |
rozšíření | V případě zadání se rozšíření uvedená v této konfiguraci nainstalují na každý uzel. | VMExtension[] |
imageReference | Odkaz na image Azure Virtual Machines Marketplace nebo prostředek image Azure vlastního virtuálního počítače. Pokud chcete získat seznam všech imagí Ověřených službou Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu. | imageReference (povinné) |
licenseType | Týká se to jenom imagí, které obsahují operační systém Windows, a měly by se používat jenom v případě, že pro uzly, které budou nasazeny, uchovávat platné místní licence. Pokud tento parametr vynecháte, nepoužije se žádná sleva za místní licencování. Hodnoty jsou: Windows_Server – místní licence je určená pro Windows Server. Windows_Client – místní licence je určená pro klienta Windows. |
řetězec |
nodeAgentSkuId | Agent uzlu Batch je program, který běží na každém uzlu ve fondu a poskytuje rozhraní příkazového a řídicího rozhraní mezi uzlem a službou Batch. Existují různé implementace agenta uzlu, označovaného jako SKU, pro různé operační systémy. Musíte zadat skladovou položku agenta uzlu, která odpovídá vybranému odkazu na image. Pokud chcete získat seznam podporovaných skladových položek agenta uzlu spolu s jejich seznamem ověřených odkazů na image, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu. | string (povinné) |
nodePlacementConfiguration | Tato konfigurace určuje pravidla, jak budou uzly ve fondu fyzicky přiděleny. | NodePlacementConfiguration |
osDisk | Obsahuje konfiguraci pro dočasné nastavení disku OSDisk. | disku |
WindowsConfiguration | Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux. | WindowsConfiguration |
VMExtension
Jméno | Popis | Hodnota |
---|---|---|
autoUpgradeMinorVersion | Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true. | Bool |
Jméno | Název rozšíření virtuálního počítače | string (povinné) |
protectedSettings | Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení. | jakýkoliv |
provisionAfterExtensions | Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit. | string[] |
vydavatel | Název vydavatele obslužné rutiny rozšíření. | string (povinné) |
nastavení | Veřejná nastavení ve formátu JSON pro rozšíření | jakýkoliv |
typ | Typ rozšíření. | string (povinné) |
typeHandlerVersion | Verze obslužné rutiny skriptu. | řetězec |
WindowsConfiguration
Jméno | Popis | Hodnota |
---|---|---|
enableAutomaticUpdates | Pokud tuto hodnotu vynecháte, výchozí hodnota je true. | Bool |
WindowsUserConfiguration
Jméno | Popis | Hodnota |
---|---|---|
loginMode | Určuje režim přihlášení pro uživatele. Výchozí hodnota pro fondy VirtualMachineConfiguration je interaktivní režim a pro fondy CloudServiceConfiguration je dávkový režim. | Batch Interaktivní |
Šablony pro rychlý start
Následující šablony pro rychlý start nasazují tento typ prostředku.
Šablona | Popis |
---|---|
fond Služby Azure Batch bez veřejných IP adres Nasadit |
Tato šablona vytvoří zjednodušený fond komunikace uzlů služby Azure Batch bez veřejných IP adres. |
Definice prostředku Terraformu (poskytovatel AzAPI)
Typ prostředku batchAccounts/pools je možné nasadit s operacemi, které cílí:
- skupiny prostředků
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Formát prostředku
Pokud chcete vytvořit prostředek Microsoft.Batch/batchAccounts/pools, přidejte do šablony následující Terraform.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Batch/batchAccounts/pools@2022-01-01"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
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 = [
{
identityReference = {
resourceId = "string"
}
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"
}
osDisk = {
ephemeralOSDiskSettings = {
placement = "CacheDisk"
}
}
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
metadata = [
{
name = "string"
value = "string"
}
]
mountConfiguration = [
{
azureBlobFileSystemConfiguration = {
accountKey = "string"
accountName = "string"
blobfuseOptions = "string"
containerName = "string"
identityReference = {
resourceId = "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 = {
dynamicVNetAssignmentScope = "string"
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 = {
identityReference = {
resourceId = "string"
}
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"
identityReference = {
resourceId = "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"
}
})
}
Hodnoty vlastností
ApplicationPackageReference
Jméno | Popis | Hodnota |
---|---|---|
id | ID balíčku aplikace, který se má nainstalovat. Musí se nacházet ve stejném účtu Batch jako fond. Může se jednat o odkaz na konkrétní verzi nebo výchozí verzi, pokud existuje. | string (povinné) |
verze | Pokud tuto hodnotu vynecháte a pro tuto aplikaci není zadána žádná výchozí verze, požadavek selže s kódem chyby InvalidApplicationPackageReferences. Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409. | řetězec |
Automatické škálováníSettings
Jméno | Popis | Hodnota |
---|---|---|
evaluationInterval | Pokud tuto hodnotu vynecháte, výchozí hodnota je 15 minut (PT15M). | řetězec |
vzorec | Vzorec pro požadovaný počet výpočetních uzlů ve fondu | string (povinné) |
AutoUserSpecification
Jméno | Popis | Hodnota |
---|---|---|
elevationLevel | Výchozí hodnota neníadmin. | Správce NonAdmin |
rozsah | Výchozí hodnota je Pool. Pokud fond používá Systém Windows, měla by být zadána hodnota Úlohy, pokud je vyžadována přísnější izolace mezi úlohami. Pokud například úloha ztlumí registr způsobem, který by mohl ovlivnit jiné úkoly, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné běžnými úkoly, ale měly by být přístupné podle počátečních úkolů. | "Bazén" Úkol |
AzureBlobFileSystemConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Tato vlastnost se vzájemně vylučují s sasKey i identitou; musí být zadána přesně jedna. | řetězec |
accountName | Název účtu úložiště Azure. | string (povinné) |
blobfuseOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
containerName | Název kontejneru služby Azure Blob Storage. | string (povinné) |
identityReference | Tato vlastnost se vzájemně vylučují s accountKey i sasKey; musí být zadána přesně jedna. | ComputeNodeIdentityReference |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
sasKey | Tato vlastnost se vzájemně vylučují s accountKey i identitou; musí být zadána přesně jedna. | řetězec |
AzureFileShareConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Klíč účtu služby Azure Storage. | string (povinné) |
accountName | Název účtu služby Azure Storage. | string (povinné) |
azureFileUrl | Toto je formulář "https://{account}.file.core.windows.net/". | string (povinné) |
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
BatchPoolIdentity
Jméno | Popis | Hodnota |
---|---|---|
typ | Typ identity, který se používá pro fond batch. | None (Žádný) UserAssigned (povinné) |
userAssignedIdentities | Seznam identit uživatelů přidružených k fondu Batch. | batchPoolIdentityUserAssignedIdentities |
BatchPoolIdentityUserAssignedIdentities
Jméno | Popis | Hodnota |
---|
CertificateReference
Jméno | Popis | Hodnota |
---|---|---|
id | Plně kvalifikované ID certifikátu, které se má nainstalovat do fondu. Musí se nacházet ve stejném účtu Batch jako fond. | string (povinné) |
storeLocation | Výchozí hodnota je currentUser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že je vytvořená pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři. | CurrentUser LocalMachine |
storeName | Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že je vytvořená pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale můžete také použít jakýkoli vlastní název úložiště. Výchozí hodnota je My. | řetězec |
viditelnost | Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu. | Řetězcové pole obsahující některou z těchto možností: RemoteUser StartTask Úkol |
CifsMountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
heslo | Heslo, které se má použít k ověřování v systému souborů CIFS. | string (povinné) |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
zdroj | Identifikátor URI systému souborů, který se má připojit. | string (povinné) |
uživatelské jméno | Uživatel, který se má použít k ověřování v systému souborů CIFS. | string (povinné) |
CloudServiceConfiguration
Jméno | Popis | Hodnota |
---|---|---|
osFamily | Možné hodnoty jsou: 2 – řada operačních systémů 2, která odpovídá systému Windows Server 2008 R2 SP1. 3– Řada operačních systémů 3, která odpovídá Systému Windows Server 2012. 4– Řada operačních systémů 4, která odpovídá Systému Windows Server 2012 R2. 5– Řada operačních systémů 5, která odpovídá Windows Serveru 2016. 6 – Řada operačních systémů 6, která odpovídá Windows Serveru 2019. Další informace najdete v tématu Vydání hostovaného operačního systému Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | string (povinné) |
osVersion | Výchozí hodnota je * určující nejnovější verzi operačního systému pro zadanou řadu operačních systémů. | řetězec |
ComputeNodeIdentityReference
Jméno | Popis | Hodnota |
---|---|---|
resourceId | ID prostředku ARM identity přiřazené uživatelem. | řetězec |
ContainerConfiguration
Jméno | Popis | Hodnota |
---|---|---|
containerImageNames | Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Image bude zdrojem z výchozího registru Dockeru, pokud není image plně kvalifikovaná s alternativním registrem. | string[] |
containerRegistries | Pokud se některé image musí stáhnout z privátního registru, který vyžaduje přihlašovací údaje, musí se tyto přihlašovací údaje zadat tady. | ContainerRegistry[] |
typ | Technologie kontejneru, která se má použít. | DockerCompatible (povinné) |
ContainerRegistry
Jméno | Popis | Hodnota |
---|---|---|
identityReference | Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. | ComputeNodeIdentityReference |
heslo | Heslo pro přihlášení k serveru registru. | řetězec |
registryServer | Pokud tuto hodnotu vynecháte, výchozí hodnota je docker.io. | řetězec |
uživatelské jméno | Uživatelské jméno pro přihlášení k serveru registru. | řetězec |
Datový disk
Jméno | Popis | Hodnota |
---|---|---|
ukrývání | Hodnoty jsou: none – Režim ukládání do mezipaměti disku není povolený. readOnly – režim ukládání do mezipaměti disku je jen pro čtení. readWrite – režim ukládání do mezipaměti disku je čtení a zápis. Výchozí hodnota pro ukládání do mezipaměti není žádná. Informace o možnostech ukládání do mezipaměti naleznete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
None (Žádný) ReadOnly ReadWrite |
diskSizeGB | Počáteční velikost disku v GB při vytváření nového datového disku. | int (povinné) |
Lun | Logická jednotka se používá k jedinečné identifikaci jednotlivých datových disků. Pokud připojujete více disků, každý by měl mít jinou logickou jednotku. Hodnota musí být v rozmezí od 0 do 63 včetně. | int (povinné) |
storageAccountType | Pokud tuto hodnotu vynecháte, výchozí hodnota je Standard_LRS. Hodnoty jsou: Standard_LRS – Datový disk by měl používat standardní místně redundantní úložiště. Premium_LRS – Datový disk by měl používat místně redundantní úložiště úrovně Premium. |
"Premium_LRS" "Standard_LRS" |
DeploymentConfiguration
Jméno | Popis | Hodnota |
---|---|---|
cloudServiceConfiguration | Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a je nutné zadat jednu z vlastností. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na UserSubscription. | CloudServiceConfiguration |
virtualMachineConfiguration | Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a je nutné zadat jednu z vlastností. | VirtualMachineConfiguration |
DiffDiskSettings
Jméno | Popis | Hodnota |
---|---|---|
umístění | Tuto vlastnost může uživatel v požadavku použít k výběru umístění, ve kterém má být operační systém. Například místo na disku mezipaměti pro dočasné zřizování disku s operačním systémem. Další informace o požadavcích na dočasné velikosti disku s operačním systémem najdete v dočasných požadavcích na velikost disku s operačním systémem pro virtuální počítače s Windows na adrese /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a virtuální počítače s Linuxem na adrese /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | CacheDisk |
DiskEncryptionConfiguration
Jméno | Popis | Hodnota |
---|---|---|
cíle | Ve fondu Linuxu se podporuje pouze dočasný disk. ve fondu Windows musí být zadány "OsDisk" a "TemporaryDisk". | Řetězcové pole obsahující některou z těchto možností: OsDisk Dočasný disk |
EnvironmentSetting
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název proměnné prostředí. | string (povinné) |
hodnota | Hodnota proměnné prostředí. | řetězec |
FixedScaleSettings
Jméno | Popis | Hodnota |
---|---|---|
nodeDeallocationOption | Pokud tuto hodnotu vynecháte, bude výchozí hodnota znovu uvedena v frontě. | 'Requeue' 'RetainedData' TaskCompletion Terminate (Ukončit) |
resizeTimeout | Výchozí hodnota je 15 minut. Hodnoty časového limitu používají formát ISO 8601. Například použijte PT10M po dobu 10 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch žádost odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek). | řetězec |
targetDedicatedNodes | Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven. | Int |
targetLowPriorityNodes | Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven. | Int |
ImageReference
Jméno | Popis | Hodnota |
---|---|---|
id | Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image Sdílené galerie imagí musí mít repliky ve stejné oblasti jako účet Azure Batch. Informace o nastavení brány firewall pro agenta uzlu Batch pro komunikaci se službou Batch najdete v tématu /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | řetězec |
nabídnout | Například UbuntuServer nebo WindowsServer. | řetězec |
vydavatel | Například Canonical nebo MicrosoftWindowsServer. | řetězec |
sku | Například 18.04-LTS nebo 2022-datacenter. | řetězec |
verze | Pokud chcete vybrat nejnovější verzi image, můžete zadat hodnotu "latest". Pokud tento parametr vynecháte, výchozí hodnota je nejnovější. | řetězec |
InboundNatPool
Jméno | Popis | Hodnota |
---|---|---|
backendPort | Musí to být jedinečné v rámci fondu batch. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 22, 3389, 29876 a 29877, protože jsou rezervované. Pokud jsou zadaná nějaká rezervovaná hodnota, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
frontendPortRangeEnd | Přijatelné hodnoty jsou v rozsahu 1 až 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny službou Batch. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
frontendPortRangeStart | Přijatelné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
Jméno | Název musí být jedinečný v rámci fondu Batch, může obsahovat písmena, číslice, podtržítka, tečky a pomlčky. Názvy musí začínat písmenem nebo číslicí, musí končit písmenem, číslem nebo podtržítkem a nesmí být delší než 77 znaků. Pokud jsou zadány neplatné hodnoty, požadavek selže se stavovým kódem HTTP 400. | string (povinné) |
networkSecurityGroupRules | Maximální počet pravidel, která je možné zadat ve všech koncových bodech ve fondu Batch, je 25. Pokud nejsou zadána žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k zadanému back-endportu. Pokud je překročen maximální počet pravidel skupiny zabezpečení sítě, požadavek selže se stavovým kódem HTTP 400. | NetworkSecurityGroupRule[] |
protokol | Protokol koncového bodu. | TCP UDP (povinné) |
LinuxUserConfiguration
Jméno | Popis | Hodnota |
---|---|---|
motoličnost | Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere gid. | Int |
sshPrivateKey | Privátní klíč nesmí být chráněný heslem. Privátní klíč se používá k automatické konfiguraci asymetrického ověřování založeného na klíči pro SSH mezi uzly ve fondu Linuxu, pokud je vlastnost enableInterNodeCommunication fondu true (je ignorována, pokud enableInterNodeCommunication je false). To provede umístěním páru klíčů do adresáře .ssh uživatele. Pokud není zadáno, není mezi uzly nakonfigurovaný protokol SSH bez hesla (není provedena žádná úprava adresáře .ssh uživatele). | řetězec |
Uid | Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere identifikátor uid. | Int |
MetadataItem
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název položky metadat. | string (povinné) |
hodnota | Hodnota položky metadat. | string (povinné) |
Microsoft.Batch/batchAccounts/pools
Jméno | Popis | Hodnota |
---|---|---|
identita | Typ identity, který se používá pro fond batch. | |
Jméno | Název prostředku | řetězec Omezení: Minimální délka = 1 Maximální délka = 64 Model = ^[a-zA-Z0-9_-]+$ (povinné) |
parent_id | ID prostředku, který je nadřazený pro tento prostředek. | ID prostředku typu: batchAccounts |
vlastnosti | Vlastnosti přidružené k fondu. | |
typ | Typ prostředku | Microsoft.Batch/batchAccounts/pools@2022-01-01" |
MountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
azureBlobFileSystemConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | AzureBlobFileSystemConfiguration |
azureFileShareConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | azureFileShareConfiguration |
cifsMountConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | CifsMountConfiguration |
NfsMountConfiguration | Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. | NFSMountConfiguration |
NetworkConfiguration
Jméno | Popis | Hodnota |
---|---|---|
dynamicVNetAssignmentScope | Rozsah dynamického přiřazení virtuální sítě. | 'job' 'none' |
endpointConfiguration | Konfigurace koncového bodu fondu je podporována pouze u fondů s vlastností virtualMachineConfiguration. | |
publicIPAddressConfiguration | Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration. | PublicIPAddressConfiguration |
subnetId | Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres pro přizpůsobení počtu uzlů ve fondu. Pokud podsíť nemá dostatek volných IP adres, fond částečně přidělí výpočetní uzly a dojde k chybě změny velikosti. Instanční objekt MicrosoftAzureBatch musí mít roli Přispěvatel klasických virtuálních počítačů Role-Based řízení přístupu (RBAC) pro zadanou virtuální síť. Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby mohla plánovat úkoly na výpočetních uzlech. To je možné ověřit kontrolou, jestli má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG). Pokud skupina zabezpečení sítě odepře komunikaci s výpočetními uzly v zadané podsíti, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Pokud má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci povoleno několik vyhrazených systémových portů. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 a port 22 pro Linux a port 3389 pro Windows. Pro fondy vytvořené s konfigurací cloudové služby povolte porty 10100, 20100 a 30100. Povolte také odchozí připojení ke službě Azure Storage na portu 443. U fondů cloudServiceConfiguration se podporují jenom klasické virtuální sítě. Další podrobnosti najdete v tématu: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | řetězec |
NetworkSecurityGroupRule
Jméno | Popis | Hodnota |
---|---|---|
přístup | Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku | Povolit Odepřít (povinné) |
priorita | Priority v rámci fondu musí být jedinečné a vyhodnocují se v pořadí podle priority. Čím nižší je číslo, tím vyšší je priorita. Můžete například zadat pravidla s čísly objednávek 150, 250 a 350. Pravidlo s číslem objednávky 150 má přednost před pravidlem, které má pořadí 250. Povolené priority jsou 150 až 4096. Pokud jsou zadány nějaké rezervované nebo duplicitní hodnoty, požadavek selže se stavovým kódem HTTP 400. | int (povinné) |
sourceAddressPrefix | Platné hodnoty jsou jedna IP adresa (tj. 10.10.10.10.10), podsíť PROTOKOLU IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou zadány jakékoli jiné hodnoty, požadavek selže se stavovým kódem HTTP 400. | string (povinné) |
sourcePortRanges | Platné hodnoty jsou *(pro všechny porty 0 – 65535) nebo pole portů nebo rozsahů portů (tj. 100–200). Porty by měly být v rozsahu 0 až 65535 a rozsahy portů nebo porty se nesmí překrývat. Pokud jsou zadány jakékoli jiné hodnoty, požadavek selže se stavovým kódem HTTP 400. Výchozí hodnota bude *. | string[] |
NFSMountConfiguration
Jméno | Popis | Hodnota |
---|---|---|
mountOptions | Jedná se o možnosti net use ve Windows a připojení v Linuxu. | řetězec |
relativeMountPath | Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR. | string (povinné) |
zdroj | Identifikátor URI systému souborů, který se má připojit. | string (povinné) |
NodePlacementConfiguration
Jméno | Popis | Hodnota |
---|---|---|
politika | Zásady přidělování, které služba Batch používá ke zřízení uzlů. Pokud není zadáno, služba Batch použije regionální politiku. | 'Oblast' 'Zónální' |
OSDisk
Jméno | Popis | Hodnota |
---|---|---|
Dočasné nastavení diskuOS | Určuje dočasné nastavení disku pro disk operačního systému používaný virtuálním počítačem. | |
PoolEndpointConfiguration
PoolProperties
Jméno | Popis | Hodnota |
---|---|---|
applicationLicenses | Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud se požaduje licence, která se nepodporuje, vytvoření fondu se nezdaří. | string[] |
applicationPackages | Změny odkazů na balíčky aplikací ovlivňují všechny nové výpočetní uzly připojující se k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nezomagí. V jakémkoli fondu je maximálně 10 odkazů na balíčky aplikací. | ApplicationPackageReference[] |
certifikáty | Pro výpočetní uzly Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři. | CertificateReference[] |
deploymentConfiguration | Použití CloudServiceConfiguration určuje, že uzly by měly být vytvářeny pomocí Azure Cloud Services (PaaS), zatímco VirtualMachineConfiguration používá Azure Virtual Machines (IaaS). | DeploymentConfiguration |
displayName | Zobrazovaný název nemusí být jedinečný a může obsahovat libovolné znaky Unicode až do maximální délky 1024. | řetězec |
interNodeCommunication | To platí pro omezení, ke kterým uzlům je možné přiřadit fond. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadána, tato hodnota je ve výchozím nastavení zakázaná. | Zakázáno Povoleno |
metadata | Služba Batch nepřiřazuje metadatům žádný význam; je výhradně pro použití uživatelského kódu. | metadataItem[] |
mountConfiguration | To podporuje Soubory Azure, NFS, CIFS/SMB a Blobfuse. | MountConfiguration[] |
networkConfiguration | Konfigurace sítě pro fond. | |
scaleSettings | Definuje požadovanou velikost fondu. Může to být buď fixedScale, kde je zadán požadovaný cílovýDedicatedNodes, nebo "autoScale", který definuje vzorec, který se pravidelně znovu vyhodnocuje. Pokud tato vlastnost není zadána, bude mít fond pevné škálování s 0 targetDedicatedNodes. | |
startTask | V operaci PATCH (update) lze tuto vlastnost nastavit na prázdný objekt, který odebere spouštěcí úlohu z fondu. | StartTask |
taskSchedulingPolicy | Pokud není zadáno, výchozí hodnota se rozloží. | TaskSchedulingPolicy |
taskSlotsPerNode | Výchozí hodnota je 1. Maximální hodnota je menší 4krát počet jader vmSize fondu nebo 256. | Int |
userAccounts | Seznam uživatelských účtů, které se mají vytvořit na každém uzlu ve fondu. | UserAccount[] |
vmSize | Informace o dostupných velikostech virtuálních počítačů pro fondy cloudových služeb (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro cloudové služby (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall. Informace o dostupných velikostech virtuálních počítačů pro fondy používající image z Marketplace virtuálních počítačů (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti virtuálních počítačů (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti virtuálních počítačů (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a těch, které mají službu Premium Storage (STANDARD_GS, STANDARD_DS a STANDARD_DSV2 series). | řetězec |
PublicIPAddressConfiguration
Jméno | Popis | Hodnota |
---|---|---|
ipAddressIds | Počet ZDE zadaných IP adres omezuje maximální velikost fondu – 100 vyhrazených uzlů nebo 100 uzlů s spotovou/nízkou prioritou je možné přidělit pro každou veřejnou IP adresu. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, by potřeboval alespoň 3 veřejné IP adresy zadané. Každý prvek této kolekce má tvar: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
poskytnutí | Výchozí hodnota je BatchManaged. | BatchManaged NoPublicIPAddresses UserManaged |
ResourceFile
Jméno | Popis | Hodnota |
---|---|---|
autoStorageContainerName | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. | řetězec |
blobPrefix | Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečným názvem souboru nebo podadresářem. Pokud předpona není zadaná, stáhnou se všechny soubory v kontejneru. | řetězec |
fileMode | Tato vlastnost se vztahuje pouze na soubory, které se stahují do výpočetních uzlů Linuxu. Bude ignorován, pokud je zadán pro resourceFile, který se stáhne do uzlu Windows. Pokud tato vlastnost není určena pro uzel Linuxu, použije se na soubor výchozí hodnota 0770. | řetězec |
filePath | Pokud je zadána vlastnost httpUrl, je souborPath vyžadován a popisuje cestu, do které se soubor stáhne, včetně názvu souboru. Jinak je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů. V případě, že se filePath používá jako adresář, všechny adresářové struktury, které jsou již přidruženy ke vstupním datům, se zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže přerušit pracovní adresář úkolu (například pomocí ..). | řetězec |
httpUrl | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL objektu blob v úložišti Azure: zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použít spravovanou identitu s oprávněním ke čtení nebo nastavit seznam ACL objektu blob nebo jeho kontejneru tak, aby umožňoval veřejný přístup. | řetězec |
identityReference | Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. | ComputeNodeIdentityReference |
storageContainerUrl | Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Tato adresa URL musí být čitelná a vypisovatelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL kontejneru v úložišti Azure: zahrnutí sdíleného přístupového podpisu (SAS) udělujícího oprávnění ke čtení a seznamu v kontejneru, použití spravované identity s oprávněními ke čtení a seznamu nebo nastavení seznamu ACL pro kontejner tak, aby umožňoval veřejný přístup. | řetězec |
ScaleSettings
StartTask
Jméno | Popis | Hodnota |
---|---|---|
commandLine | Příkazový řádek se nespustí pod prostředím, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí na příkazovém řádku, například pomocí příkazu cmd /c MyCommand ve Windows nebo /bin/sh -c MyCommand v Linuxu. Vyžaduje se, pokud jsou zadány jakékoli další vlastnosti startTask. | řetězec |
containerSettings | Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen adresářů Azure Batch na uzlu) mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru. | TaskContainerSettings |
environmentSettings | Seznam nastavení proměnných prostředí pro spouštěcí úlohu. | EnvironmentSetting[] |
maxTaskRetryCount | Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování). | Int |
resourceFiles | Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. | ResourceFile[] |
userIdentity | Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úkol jedinečný. | userIdentity |
waitForSuccess | Pokud hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje spouštěcí úlohu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o plánování chyb. Pokud je false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V tomto případě můžou na výpočetním uzlu začít spouštět jiné úkoly, zatímco spouštěcí úkol je stále spuštěný; i v případě, že spouštěcí úkol selže, budou na uzlu i nadále naplánované nové úkoly. Výchozí hodnota je true. | Bool |
TaskContainerSettings
Jméno | Popis | Hodnota |
---|---|---|
containerRunOptions | Tyto další možnosti se předávají jako argumenty příkazu "docker create" kromě těch, které řídí služba Batch. | řetězec |
imageName | Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Pokud v názvu image není k dispozici žádná značka, použije se jako výchozí značka :latest. | string (povinné) |
registr | Toto nastavení je možné vynechat, pokud již bylo k dispozici při vytváření fondu. | ContainerRegistry |
workingDirectory | Příznak označující, kde je pracovní adresář úloh kontejneru. Výchozí hodnota je taskWorkingDirectory. | ContainerImageDefault TaskWorkingDirectory |
TaskSchedulingPolicy
Jméno | Popis | Hodnota |
---|---|---|
nodeFillType | Jak se mají úkoly distribuovat napříč výpočetními uzly. | Balíček "Rozprostřený" (povinné) |
UserAccount
Jméno | Popis | Hodnota |
---|---|---|
elevationLevel | nonAdmin – Automatický uživatel je standardní uživatel bez zvýšeného přístupu. admin – Automatický uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce. Výchozí hodnota neníadmin. | Správce NonAdmin |
linuxUserConfiguration | Tato vlastnost se ignoruje, pokud je zadána ve fondu Windows. Pokud není zadaný, uživatel se vytvoří s výchozími možnostmi. | LinuxUserConfiguration |
Jméno | Název uživatelského účtu. | string (povinné) |
heslo | Heslo pro uživatelský účet. | string (povinné) |
windowsUserConfiguration | Tuto vlastnost lze zadat pouze v případě, že je uživatel ve fondu Windows. Pokud není zadaný a ve fondu Windows, vytvoří se uživatel s výchozími možnostmi. | WindowsUserConfiguration |
UserAssignedIdentities
Jméno | Popis | Hodnota |
---|
UserIdentity
VirtualMachineConfiguration
Jméno | Popis | Hodnota |
---|---|---|
containerConfiguration | Pokud je zadáno, provede se nastavení na každém uzlu ve fondu, aby se úlohy mohly spouštět v kontejnerech. Všechny běžné úlohy a úlohy správce úloh spuštěné v tomto fondu musí určovat vlastnost containerSettings a všechny ostatní úkoly ho mohou určit. | ContainerConfiguration |
dataDisks | Tato vlastnost musí být zadána, pokud výpočetní uzly ve fondu musí mít připojené prázdné datové disky. | DataDisk[] |
diskEncryptionConfiguration | Pokud je zadáno, šifrování se provádí na každém uzlu ve fondu během zřizování uzlů. | DiskEncryptionConfiguration |
rozšíření | V případě zadání se rozšíření uvedená v této konfiguraci nainstalují na každý uzel. | VMExtension[] |
imageReference | Odkaz na image Azure Virtual Machines Marketplace nebo prostředek image Azure vlastního virtuálního počítače. Pokud chcete získat seznam všech imagí Ověřených službou Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu. | imageReference (povinné) |
licenseType | Týká se to jenom imagí, které obsahují operační systém Windows, a měly by se používat jenom v případě, že pro uzly, které budou nasazeny, uchovávat platné místní licence. Pokud tento parametr vynecháte, nepoužije se žádná sleva za místní licencování. Hodnoty jsou: Windows_Server – místní licence je určená pro Windows Server. Windows_Client – místní licence je určená pro klienta Windows. |
řetězec |
nodeAgentSkuId | Agent uzlu Batch je program, který běží na každém uzlu ve fondu a poskytuje rozhraní příkazového a řídicího rozhraní mezi uzlem a službou Batch. Existují různé implementace agenta uzlu, označovaného jako SKU, pro různé operační systémy. Musíte zadat skladovou položku agenta uzlu, která odpovídá vybranému odkazu na image. Pokud chcete získat seznam podporovaných skladových položek agenta uzlu spolu s jejich seznamem ověřených odkazů na image, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu. | string (povinné) |
nodePlacementConfiguration | Tato konfigurace určuje pravidla, jak budou uzly ve fondu fyzicky přiděleny. | NodePlacementConfiguration |
osDisk | Obsahuje konfiguraci pro dočasné nastavení disku OSDisk. | disku |
WindowsConfiguration | Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux. | WindowsConfiguration |
VMExtension
Jméno | Popis | Hodnota |
---|---|---|
autoUpgradeMinorVersion | Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true. | Bool |
Jméno | Název rozšíření virtuálního počítače | string (povinné) |
protectedSettings | Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení. | jakýkoliv |
provisionAfterExtensions | Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit. | string[] |
vydavatel | Název vydavatele obslužné rutiny rozšíření. | string (povinné) |
nastavení | Veřejná nastavení ve formátu JSON pro rozšíření | jakýkoliv |
typ | Typ rozšíření. | string (povinné) |
typeHandlerVersion | Verze obslužné rutiny skriptu. | řetězec |
WindowsConfiguration
Jméno | Popis | Hodnota |
---|---|---|
enableAutomaticUpdates | Pokud tuto hodnotu vynecháte, výchozí hodnota je true. | Bool |
WindowsUserConfiguration
Jméno | Popis | Hodnota |
---|---|---|
loginMode | Určuje režim přihlášení pro uživatele. Výchozí hodnota pro fondy VirtualMachineConfiguration je interaktivní režim a pro fondy CloudServiceConfiguration je dávkový režim. | Batch Interaktivní |