Microsoft.Batch batchAccounts/pools
- nejnovější
- 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
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@2024-02-01' = {
name: 'string'
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
osFamily: 'string'
osVersion: 'string'
}
virtualMachineConfiguration: {
containerConfiguration: {
containerImageNames: [
'string'
]
containerRegistries: [
{
identityReference: {
resourceId: 'string'
}
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'string'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
diskEncryptionConfiguration: {
targets: [
'string'
]
}
extensions: [
{
autoUpgradeMinorVersion: bool
enableAutomaticUpgrade: bool
name: 'string'
protectedSettings: any()
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any()
type: 'string'
typeHandlerVersion: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
nodePlacementConfiguration: {
policy: 'string'
}
osDisk: {
caching: 'string'
diskSizeGB: int
ephemeralOSDiskSettings: {
placement: 'CacheDisk'
}
managedDisk: {
storageAccountType: 'string'
}
writeAcceleratorEnabled: bool
}
securityProfile: {
encryptionAtHost: bool
securityType: 'trustedLaunch'
uefiSettings: {
secureBootEnabled: bool
vTpmEnabled: bool
}
}
serviceArtifactReference: {
id: 'string'
}
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'
enableAcceleratedNetworking: bool
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'
}
resourceTags: {}
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
}
targetNodeCommunicationMode: 'string'
taskSchedulingPolicy: {
nodeFillType: 'string'
}
taskSlotsPerNode: int
upgradePolicy: {
automaticOSUpgradePolicy: {
disableAutomaticRollback: bool
enableAutomaticOSUpgrade: bool
osRollingUpgradeDeferral: bool
useRollingUpgradePolicy: bool
}
mode: 'string'
rollingUpgradePolicy: {
enableCrossZoneUpgrade: bool
maxBatchInstancePercent: int
maxUnhealthyInstancePercent: int
maxUnhealthyUpgradedInstancePercent: int
pauseTimeBetweenBatches: 'string'
prioritizeUnhealthyInstances: bool
rollbackFailedInstancesOnPolicyBreach: bool
}
}
userAccounts: [
{
elevationLevel: 'string'
linuxUserConfiguration: {
gid: int
sshPrivateKey: 'string'
uid: int
}
name: 'string'
password: 'string'
windowsUserConfiguration: {
loginMode: 'string'
}
}
]
vmSize: 'string'
}
}
Hodnoty vlastností
batchAccounts/pools
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název prostředku Podívejte se, jak nastavit názvy a typy podřízených prostředků v Bicep. |
string (povinné) Limit znaků: 1-64 Platné znaky: Alfanumerické znaky, podtržítka a pomlčky |
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 |
identita | Typ identity, který se používá pro fond batch. | |
vlastnosti | Vlastnosti přidružené k fondu. | |
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 |
---|---|---|
{přizpůsobená vlastnost} | userAssignedIdentities |
UserAssignedIdentities
Tento objekt neobsahuje žádné vlastnosti, které se mají nastavit během nasazení. Všechny vlastnosti jsou Jen pro čtení.
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. Upozornění: Tato vlastnost je zastaralá a bude odebrána po únoru 2024. Místo toho použijte |
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. | |
značky prostředků | Uživatelem definované značky, které se mají přidružit k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost lze zadat pouze při vytvoření účtu Batch s vlastností poolAllocationMode nastavenou na UserSubscription. | objekt |
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 |
targetNodeCommunicationMode | Pokud tuto hodnotu vynecháte, výchozí hodnota je Výchozí. | Classic Výchozí Zjednodušená |
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 |
upgradePolicy | Popisuje zásady upgradu – automatické, ruční nebo postupné. | UpgradePolicy |
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) (/azure/virtual-machines/sizes-general) nebo Velikosti pro virtuální počítače (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 |
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 |
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 |
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 |
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 |
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 |
securityProfile | Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů. | |
serviceArtifactReference | Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | ServiceArtifactReference |
WindowsConfiguration | Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux. | WindowsConfiguration |
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. | "CriCompatible" (Nekompatibilní) 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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
ComputeNodeIdentityReference
Jméno | Popis | Hodnota |
---|---|---|
resourceId | ID prostředku ARM identity přiřazené uživatelem. | ř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 najdete 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" "StandardSSD_LRS" "Standard_LRS" |
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 |
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 |
enableAutomaticUpgrade | Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření. | 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í. | Pro Bicep můžete použít funkci any(). |
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í | Pro Bicep můžete použít funkci any(). |
typ | Typ rozšíření. | string (povinné) |
typeHandlerVersion | Verze obslužné rutiny skriptu. | řetězec |
ImageReference
Jméno | Popis | Hodnota |
---|---|---|
id | Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image galerie výpočetních prostředků Azure 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 |
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 |
---|---|---|
ukrývání | Typ ukládání do mezipaměti pro disk. | None (Žádný) ReadOnly ReadWrite |
diskSizeGB | Počáteční velikost disku v GB při vytváření nového disku s operačním systémem | Int |
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. | |
managedDisk | spravovaného disku |
|
writeAcceleratorEnabled | Určuje, jestli má být na disku povolený nebo zakázaný writeAccelerator. | Bool |
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 |
ManagedDisk
Jméno | Popis | Hodnota |
---|---|---|
storageAccountType | Typ účtu úložiště pro použití při vytváření datových disků nebo disku s operačním systémem. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
SecurityProfile
Jméno | Popis | Hodnota |
---|---|---|
encryptionAtHost | Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli. | Bool |
securityType | Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu. | 'trustedLaunch' |
uefiSettings | Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače. | UefiSettings |
UefiSettings
Jméno | Popis | Hodnota |
---|---|---|
secureBootEnabled | Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění. | Bool |
vTpmEnabled | Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM. | Bool |
ServiceArtifactReference
Jméno | Popis | Hodnota |
---|---|---|
id | Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | string (povinné) |
WindowsConfiguration
Jméno | Popis | Hodnota |
---|---|---|
enableAutomaticUpdates | Pokud tuto hodnotu vynecháte, výchozí hodnota je true. | Bool |
MetadataItem
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název položky metadat. | string (povinné) |
hodnota | Hodnota položky metadat. | string (povinné) |
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 |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
AzureFileShareConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Klíč účtu služby Azure Storage. | string (povinné) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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é) |
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é) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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é) |
userName | Uživatel, který se má použít k ověřování v systému souborů CIFS. | string (povinné) |
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é) |
NetworkConfiguration
Jméno | Popis | Hodnota |
---|---|---|
dynamicVnetAssignmentScope | Rozsah dynamického přiřazení virtuální sítě. | 'job' 'none' |
enableAcceleratedNetworking | Akcelerované síťové služby umožňují virtualizaci V/V s jedním kořenovým serverem (SR-IOV) na virtuální počítač, což může vést ke zvýšení výkonu sítě. Další podrobnosti najdete v tématu: /azure/virtual-network/accelerated-networking-overview. | Bool |
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 |
PoolEndpointConfiguration
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é) |
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[] |
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 |
ScaleSettings
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é) |
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 |
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 úlohu bez omezení. Výchozí hodnota je 0 | 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 |
EnvironmentSetting
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název proměnné prostředí. | string (povinné) |
hodnota | Hodnota proměnné prostředí. | řetězec |
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 |
UserIdentity
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 |
TaskSchedulingPolicy
Jméno | Popis | Hodnota |
---|---|---|
nodeFillType | Jak se mají úkoly distribuovat napříč výpočetními uzly. | Balíček "Rozprostřený" (povinné) |
UpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
automaticOSUpgradePolicy | Parametry konfigurace používané k automatickému upgradu operačního systému. | AutomaticOSUpgradePolicy |
režim | Určuje režim upgradu na virtuální počítače ve škálovací sadě. Možné hodnoty: Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade. Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně. rolling – Škálovací sada provádí aktualizace v dávkách s volitelnou dobou pozastavení mezi. |
"automatic" "manuál" "rolling" (povinné) |
rollingUpgradePolicy | Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration. | RollingUpgradePolicy |
AutomaticOSUpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
disableAutomaticRollback | Určuje, jestli má být funkce vrácení image operačního systému zakázaná. | Bool |
enableAutomaticOSUpgrade | Označuje, jestli se upgrady operačního systému mají automaticky použít u instancí škálovací sady, a to v případě, že bude k dispozici novější verze image operačního systému. Pokud je tato hodnota nastavena na true pro fondy založené na Windows, WindowsConfiguration.enableAutomaticUpdates nelze nastavit na hodnotu true. |
Bool |
osRollingUpgradeDeferral | Odložit upgrady operačního systému na TVM, pokud jsou spuštěné úlohy. | Bool |
useRollingUpgradePolicy | Označuje, jestli se při automatickém upgradu operačního systému mají používat zásady postupného upgradu. Pokud v sadě VMSS není definovaná žádná zásada, automatický upgrade operačního systému se vrátí k výchozím zásadám. | Bool |
RollingUpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
enableCrossZoneUpgrade | Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky. Pokud toto pole není nastavené, Azure Batch nenastaví výchozí hodnotu. Hodnota enableCrossZoneUpgrade na vytvořené VirtualMachineScaleSet bude rozhodnuto ve výchozích konfiguracích v VirtualMachineScaleSet. Toto pole je možné nastavit na hodnotu true nebo false pouze při použití NodePlacementConfiguration jako zónového pole. | Bool |
maxBatchInstancePercent | Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku v předchozích nebo budoucích dávkách, můžou způsobit snížení procenta instancí v dávce, aby se zajistila vyšší spolehlivost. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. | Int Omezení: Minimální hodnota = 5 Maximální hodnota = 100 |
maxUnhealthyInstancePercent | Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje před spuštěním jakékoli dávky. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. | Int Omezení: Minimální hodnota = 5 Maximální hodnota = 100 |
maxUnhealthyUpgradedInstancePercent | Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Hodnota tohoto pole by měla být v rozmezí od 0 do 100 (včetně). | Int Omezení: Minimální hodnota = 0 Maximální hodnota = 100 |
pauseTimeBetweenBatches | Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače v jedné dávce a spuštěním další dávky. Doba trvání by měla být zadána ve formátu ISO 8601. | řetězec |
prioritizeUnhealthyInstances | Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před všemi instancemi, které jsou v pořádku. | Bool |
rollbackFailedInstancesOnPolicyBreach | Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu | Bool |
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. Názvy můžou obsahovat libovolné znaky Unicode až do maximální délky 20. | string (povinné) |
heslo | Heslo pro uživatelský účet. | string (povinné) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
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 nasazení |
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": "2024-02-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": "string"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"diskEncryptionConfiguration": {
"targets": [ "string" ]
},
"extensions": [
{
"autoUpgradeMinorVersion": "bool",
"enableAutomaticUpgrade": "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": {
"caching": "string",
"diskSizeGB": "int",
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
},
"managedDisk": {
"storageAccountType": "string"
},
"writeAcceleratorEnabled": "bool"
},
"securityProfile": {
"encryptionAtHost": "bool",
"securityType": "trustedLaunch",
"uefiSettings": {
"secureBootEnabled": "bool",
"vTpmEnabled": "bool"
}
},
"serviceArtifactReference": {
"id": "string"
},
"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",
"enableAcceleratedNetworking": "bool",
"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"
},
"resourceTags": {},
"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"
},
"targetNodeCommunicationMode": "string",
"taskSchedulingPolicy": {
"nodeFillType": "string"
},
"taskSlotsPerNode": "int",
"upgradePolicy": {
"automaticOSUpgradePolicy": {
"disableAutomaticRollback": "bool",
"enableAutomaticOSUpgrade": "bool",
"osRollingUpgradeDeferral": "bool",
"useRollingUpgradePolicy": "bool"
},
"mode": "string",
"rollingUpgradePolicy": {
"enableCrossZoneUpgrade": "bool",
"maxBatchInstancePercent": "int",
"maxUnhealthyInstancePercent": "int",
"maxUnhealthyUpgradedInstancePercent": "int",
"pauseTimeBetweenBatches": "string",
"prioritizeUnhealthyInstances": "bool",
"rollbackFailedInstancesOnPolicyBreach": "bool"
}
},
"userAccounts": [
{
"elevationLevel": "string",
"linuxUserConfiguration": {
"gid": "int",
"sshPrivateKey": "string",
"uid": "int"
},
"name": "string",
"password": "string",
"windowsUserConfiguration": {
"loginMode": "string"
}
}
],
"vmSize": "string"
}
}
Hodnoty vlastností
batchAccounts/pools
Jméno | Popis | Hodnota |
---|---|---|
typ | Typ prostředku | Microsoft.Batch/batchAccounts/pools |
apiVersion | Verze rozhraní API prostředku | '2024-02-01' |
Jméno | Název prostředku Podívejte se, jak nastavit názvy a typy podřízených prostředků v šablonách JSON ARM. |
string (povinné) Limit znaků: 1-64 Platné znaky: Alfanumerické znaky, podtržítka a pomlčky |
identita | Typ identity, který se používá pro fond batch. | |
vlastnosti | Vlastnosti přidružené k fondu. | |
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 |
---|---|---|
{přizpůsobená vlastnost} | userAssignedIdentities |
UserAssignedIdentities
Tento objekt neobsahuje žádné vlastnosti, které se mají nastavit během nasazení. Všechny vlastnosti jsou Jen pro čtení.
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. Upozornění: Tato vlastnost je zastaralá a bude odebrána po únoru 2024. Místo toho použijte |
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. | |
značky prostředků | Uživatelem definované značky, které se mají přidružit k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost lze zadat pouze při vytvoření účtu Batch s vlastností poolAllocationMode nastavenou na UserSubscription. | objekt |
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 |
targetNodeCommunicationMode | Pokud tuto hodnotu vynecháte, výchozí hodnota je Výchozí. | Classic Výchozí Zjednodušená |
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 |
upgradePolicy | Popisuje zásady upgradu – automatické, ruční nebo postupné. | UpgradePolicy |
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) (/azure/virtual-machines/sizes-general) nebo Velikosti pro virtuální počítače (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 |
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 |
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 |
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 |
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 |
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 |
securityProfile | Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů. | |
serviceArtifactReference | Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | ServiceArtifactReference |
WindowsConfiguration | Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux. | WindowsConfiguration |
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. | "CriCompatible" (Nekompatibilní) 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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
ComputeNodeIdentityReference
Jméno | Popis | Hodnota |
---|---|---|
resourceId | ID prostředku ARM identity přiřazené uživatelem. | ř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 najdete 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" "StandardSSD_LRS" "Standard_LRS" |
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 |
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 |
enableAutomaticUpgrade | Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření. | 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í. | |
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í | |
typ | Typ rozšíření. | string (povinné) |
typeHandlerVersion | Verze obslužné rutiny skriptu. | řetězec |
ImageReference
Jméno | Popis | Hodnota |
---|---|---|
id | Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image galerie výpočetních prostředků Azure 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 |
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 |
---|---|---|
ukrývání | Typ ukládání do mezipaměti pro disk. | None (Žádný) ReadOnly ReadWrite |
diskSizeGB | Počáteční velikost disku v GB při vytváření nového disku s operačním systémem | Int |
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. | |
managedDisk | spravovaného disku |
|
writeAcceleratorEnabled | Určuje, jestli má být na disku povolený nebo zakázaný writeAccelerator. | Bool |
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 |
ManagedDisk
Jméno | Popis | Hodnota |
---|---|---|
storageAccountType | Typ účtu úložiště pro použití při vytváření datových disků nebo disku s operačním systémem. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
SecurityProfile
Jméno | Popis | Hodnota |
---|---|---|
encryptionAtHost | Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli. | Bool |
securityType | Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu. | 'trustedLaunch' |
uefiSettings | Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače. | UefiSettings |
UefiSettings
Jméno | Popis | Hodnota |
---|---|---|
secureBootEnabled | Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění. | Bool |
vTpmEnabled | Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM. | Bool |
ServiceArtifactReference
Jméno | Popis | Hodnota |
---|---|---|
id | Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | string (povinné) |
WindowsConfiguration
Jméno | Popis | Hodnota |
---|---|---|
enableAutomaticUpdates | Pokud tuto hodnotu vynecháte, výchozí hodnota je true. | Bool |
MetadataItem
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název položky metadat. | string (povinné) |
hodnota | Hodnota položky metadat. | string (povinné) |
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 |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
AzureFileShareConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Klíč účtu služby Azure Storage. | string (povinné) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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é) |
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é) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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é) |
userName | Uživatel, který se má použít k ověřování v systému souborů CIFS. | string (povinné) |
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é) |
NetworkConfiguration
Jméno | Popis | Hodnota |
---|---|---|
dynamicVnetAssignmentScope | Rozsah dynamického přiřazení virtuální sítě. | 'job' 'none' |
enableAcceleratedNetworking | Akcelerované síťové služby umožňují virtualizaci V/V s jedním kořenovým serverem (SR-IOV) na virtuální počítač, což může vést ke zvýšení výkonu sítě. Další podrobnosti najdete v tématu: /azure/virtual-network/accelerated-networking-overview. | Bool |
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 |
PoolEndpointConfiguration
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é) |
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[] |
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 |
ScaleSettings
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é) |
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 |
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 úlohu bez omezení. Výchozí hodnota je 0 | 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 |
EnvironmentSetting
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název proměnné prostředí. | string (povinné) |
hodnota | Hodnota proměnné prostředí. | řetězec |
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 |
UserIdentity
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 |
TaskSchedulingPolicy
Jméno | Popis | Hodnota |
---|---|---|
nodeFillType | Jak se mají úkoly distribuovat napříč výpočetními uzly. | Balíček "Rozprostřený" (povinné) |
UpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
automaticOSUpgradePolicy | Parametry konfigurace používané k automatickému upgradu operačního systému. | AutomaticOSUpgradePolicy |
režim | Určuje režim upgradu na virtuální počítače ve škálovací sadě. Možné hodnoty: Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade. Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně. rolling – Škálovací sada provádí aktualizace v dávkách s volitelnou dobou pozastavení mezi. |
"automatic" "manuál" "rolling" (povinné) |
rollingUpgradePolicy | Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration. | RollingUpgradePolicy |
AutomaticOSUpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
disableAutomaticRollback | Určuje, jestli má být funkce vrácení image operačního systému zakázaná. | Bool |
enableAutomaticOSUpgrade | Označuje, jestli se upgrady operačního systému mají automaticky použít u instancí škálovací sady, a to v případě, že bude k dispozici novější verze image operačního systému. Pokud je tato hodnota nastavena na true pro fondy založené na Windows, WindowsConfiguration.enableAutomaticUpdates nelze nastavit na hodnotu true. |
Bool |
osRollingUpgradeDeferral | Odložit upgrady operačního systému na TVM, pokud jsou spuštěné úlohy. | Bool |
useRollingUpgradePolicy | Označuje, jestli se při automatickém upgradu operačního systému mají používat zásady postupného upgradu. Pokud v sadě VMSS není definovaná žádná zásada, automatický upgrade operačního systému se vrátí k výchozím zásadám. | Bool |
RollingUpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
enableCrossZoneUpgrade | Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky. Pokud toto pole není nastavené, Azure Batch nenastaví výchozí hodnotu. Hodnota enableCrossZoneUpgrade na vytvořené VirtualMachineScaleSet bude rozhodnuto ve výchozích konfiguracích v VirtualMachineScaleSet. Toto pole je možné nastavit na hodnotu true nebo false pouze při použití NodePlacementConfiguration jako zónového pole. | Bool |
maxBatchInstancePercent | Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku v předchozích nebo budoucích dávkách, můžou způsobit snížení procenta instancí v dávce, aby se zajistila vyšší spolehlivost. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. | Int Omezení: Minimální hodnota = 5 Maximální hodnota = 100 |
maxUnhealthyInstancePercent | Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje před spuštěním jakékoli dávky. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. | Int Omezení: Minimální hodnota = 5 Maximální hodnota = 100 |
maxUnhealthyUpgradedInstancePercent | Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Hodnota tohoto pole by měla být v rozmezí od 0 do 100 (včetně). | Int Omezení: Minimální hodnota = 0 Maximální hodnota = 100 |
pauseTimeBetweenBatches | Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače v jedné dávce a spuštěním další dávky. Doba trvání by měla být zadána ve formátu ISO 8601. | řetězec |
prioritizeUnhealthyInstances | Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před všemi instancemi, které jsou v pořádku. | Bool |
rollbackFailedInstancesOnPolicyBreach | Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu | Bool |
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. Názvy můžou obsahovat libovolné znaky Unicode až do maximální délky 20. | string (povinné) |
heslo | Heslo pro uživatelský účet. | string (povinné) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
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 nasazení |
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@2024-02-01"
name = "string"
parent_id = "string"
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
applicationLicenses = [
"string"
]
applicationPackages = [
{
id = "string"
version = "string"
}
]
certificates = [
{
id = "string"
storeLocation = "string"
storeName = "string"
visibility = [
"string"
]
}
]
deploymentConfiguration = {
cloudServiceConfiguration = {
osFamily = "string"
osVersion = "string"
}
virtualMachineConfiguration = {
containerConfiguration = {
containerImageNames = [
"string"
]
containerRegistries = [
{
identityReference = {
resourceId = "string"
}
password = "string"
registryServer = "string"
username = "string"
}
]
type = "string"
}
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
diskEncryptionConfiguration = {
targets = [
"string"
]
}
extensions = [
{
autoUpgradeMinorVersion = bool
enableAutomaticUpgrade = bool
name = "string"
provisionAfterExtensions = [
"string"
]
publisher = "string"
type = "string"
typeHandlerVersion = "string"
}
]
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
nodePlacementConfiguration = {
policy = "string"
}
osDisk = {
caching = "string"
diskSizeGB = int
ephemeralOSDiskSettings = {
placement = "CacheDisk"
}
managedDisk = {
storageAccountType = "string"
}
writeAcceleratorEnabled = bool
}
securityProfile = {
encryptionAtHost = bool
securityType = "trustedLaunch"
uefiSettings = {
secureBootEnabled = bool
vTpmEnabled = bool
}
}
serviceArtifactReference = {
id = "string"
}
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"
enableAcceleratedNetworking = bool
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"
}
resourceTags = {}
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
}
targetNodeCommunicationMode = "string"
taskSchedulingPolicy = {
nodeFillType = "string"
}
taskSlotsPerNode = int
upgradePolicy = {
automaticOSUpgradePolicy = {
disableAutomaticRollback = bool
enableAutomaticOSUpgrade = bool
osRollingUpgradeDeferral = bool
useRollingUpgradePolicy = bool
}
mode = "string"
rollingUpgradePolicy = {
enableCrossZoneUpgrade = bool
maxBatchInstancePercent = int
maxUnhealthyInstancePercent = int
maxUnhealthyUpgradedInstancePercent = int
pauseTimeBetweenBatches = "string"
prioritizeUnhealthyInstances = bool
rollbackFailedInstancesOnPolicyBreach = bool
}
}
userAccounts = [
{
elevationLevel = "string"
linuxUserConfiguration = {
gid = int
sshPrivateKey = "string"
uid = int
}
name = "string"
password = "string"
windowsUserConfiguration = {
loginMode = "string"
}
}
]
vmSize = "string"
}
})
}
Hodnoty vlastností
batchAccounts/pools
Jméno | Popis | Hodnota |
---|---|---|
typ | Typ prostředku | Microsoft.Batch/batchAccounts/pools@2024-02-01 |
Jméno | Název prostředku | string (povinné) Limit znaků: 1-64 Platné znaky: Alfanumerické znaky, podtržítka a pomlčky |
parent_id | ID prostředku, který je nadřazený pro tento prostředek. | ID prostředku typu: batchAccounts |
identita | Typ identity, který se používá pro fond batch. | |
vlastnosti | Vlastnosti přidružené k fondu. | |
BatchPoolIdentity
Jméno | Popis | Hodnota |
---|---|---|
typ | Typ identity, který se používá pro fond batch. | UserAssigned (povinné) |
identity_ids | Seznam identit uživatelů přidružených k fondu Batch. | Pole ID identit uživatele |
BatchPoolIdentityUserAssignedIdentities
Jméno | Popis | Hodnota |
---|---|---|
{přizpůsobená vlastnost} | userAssignedIdentities |
UserAssignedIdentities
Tento objekt neobsahuje žádné vlastnosti, které se mají nastavit během nasazení. Všechny vlastnosti jsou Jen pro čtení.
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. Upozornění: Tato vlastnost je zastaralá a bude odebrána po únoru 2024. Místo toho použijte |
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. | |
značky prostředků | Uživatelem definované značky, které se mají přidružit k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost lze zadat pouze při vytvoření účtu Batch s vlastností poolAllocationMode nastavenou na UserSubscription. | objekt |
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 |
targetNodeCommunicationMode | Pokud tuto hodnotu vynecháte, výchozí hodnota je Výchozí. | "Classic" "Výchozí" "Zjednodušená" |
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 |
upgradePolicy | Popisuje zásady upgradu – automatické, ruční nebo postupné. | UpgradePolicy |
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) (/azure/virtual-machines/sizes-general) nebo Velikosti pro virtuální počítače (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 |
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 |
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" |
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 |
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 |
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 |
securityProfile | Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů. | |
serviceArtifactReference | Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | ServiceArtifactReference |
WindowsConfiguration | Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux. | WindowsConfiguration |
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. | "CriCompatible" (Nekompatibilní) 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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
ComputeNodeIdentityReference
Jméno | Popis | Hodnota |
---|---|---|
resourceId | ID prostředku ARM identity přiřazené uživatelem. | ř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 najdete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Žádný" "Jen pro čtení" "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" "StandardSSD_LRS" "Standard_LRS" |
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" |
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 |
enableAutomaticUpgrade | Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření. | 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í. | |
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í | |
typ | Typ rozšíření. | string (povinné) |
typeHandlerVersion | Verze obslužné rutiny skriptu. | řetězec |
ImageReference
Jméno | Popis | Hodnota |
---|---|---|
id | Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image galerie výpočetních prostředků Azure 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 |
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ónová" |
OSDisk
Jméno | Popis | Hodnota |
---|---|---|
ukrývání | Typ ukládání do mezipaměti pro disk. | "Žádný" "Jen pro čtení" "ReadWrite" |
diskSizeGB | Počáteční velikost disku v GB při vytváření nového disku s operačním systémem | Int |
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. | |
managedDisk | spravovaného disku |
|
writeAcceleratorEnabled | Určuje, jestli má být na disku povolený nebo zakázaný writeAccelerator. | Bool |
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" |
ManagedDisk
Jméno | Popis | Hodnota |
---|---|---|
storageAccountType | Typ účtu úložiště pro použití při vytváření datových disků nebo disku s operačním systémem. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
SecurityProfile
Jméno | Popis | Hodnota |
---|---|---|
encryptionAtHost | Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli. | Bool |
securityType | Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu. | "trustedLaunch" |
uefiSettings | Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače. | UefiSettings |
UefiSettings
Jméno | Popis | Hodnota |
---|---|---|
secureBootEnabled | Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění. | Bool |
vTpmEnabled | Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM. | Bool |
ServiceArtifactReference
Jméno | Popis | Hodnota |
---|---|---|
id | Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | string (povinné) |
WindowsConfiguration
Jméno | Popis | Hodnota |
---|---|---|
enableAutomaticUpdates | Pokud tuto hodnotu vynecháte, výchozí hodnota je true. | Bool |
MetadataItem
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název položky metadat. | string (povinné) |
hodnota | Hodnota položky metadat. | string (povinné) |
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 |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
AzureFileShareConfiguration
Jméno | Popis | Hodnota |
---|---|---|
accountKey | Klíč účtu služby Azure Storage. | string (povinné) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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é) |
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é) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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é) |
userName | Uživatel, který se má použít k ověřování v systému souborů CIFS. | string (povinné) |
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é) |
NetworkConfiguration
Jméno | Popis | Hodnota |
---|---|---|
dynamicVnetAssignmentScope | Rozsah dynamického přiřazení virtuální sítě. | "job" "none" |
enableAcceleratedNetworking | Akcelerované síťové služby umožňují virtualizaci V/V s jedním kořenovým serverem (SR-IOV) na virtuální počítač, což může vést ke zvýšení výkonu sítě. Další podrobnosti najdete v tématu: /azure/virtual-network/accelerated-networking-overview. | Bool |
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 |
PoolEndpointConfiguration
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é) |
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[] |
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" |
ScaleSettings
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é) |
FixedScaleSettings
Jméno | Popis | Hodnota |
---|---|---|
nodeDeallocationOption | Pokud tuto hodnotu vynecháte, bude výchozí hodnota znovu uvedena v frontě. | "Znovu načítá" "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 |
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 úlohu bez omezení. Výchozí hodnota je 0 | 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" |
EnvironmentSetting
Jméno | Popis | Hodnota |
---|---|---|
Jméno | Název proměnné prostředí. | string (povinné) |
hodnota | Hodnota proměnné prostředí. | řetězec |
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 |
UserIdentity
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" |
TaskSchedulingPolicy
Jméno | Popis | Hodnota |
---|---|---|
nodeFillType | Jak se mají úkoly distribuovat napříč výpočetními uzly. | "Balíček" "Spread" (povinné) |
UpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
automaticOSUpgradePolicy | Parametry konfigurace používané k automatickému upgradu operačního systému. | AutomaticOSUpgradePolicy |
režim | Určuje režim upgradu na virtuální počítače ve škálovací sadě. Možné hodnoty: Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade. Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně. rolling – Škálovací sada provádí aktualizace v dávkách s volitelnou dobou pozastavení mezi. |
"automatic" "ruční" "rolling" (povinné) |
rollingUpgradePolicy | Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration. | RollingUpgradePolicy |
AutomaticOSUpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
disableAutomaticRollback | Určuje, jestli má být funkce vrácení image operačního systému zakázaná. | Bool |
enableAutomaticOSUpgrade | Označuje, jestli se upgrady operačního systému mají automaticky použít u instancí škálovací sady, a to v případě, že bude k dispozici novější verze image operačního systému. Pokud je tato hodnota nastavena na true pro fondy založené na Windows, WindowsConfiguration.enableAutomaticUpdates nelze nastavit na hodnotu true. |
Bool |
osRollingUpgradeDeferral | Odložit upgrady operačního systému na TVM, pokud jsou spuštěné úlohy. | Bool |
useRollingUpgradePolicy | Označuje, jestli se při automatickém upgradu operačního systému mají používat zásady postupného upgradu. Pokud v sadě VMSS není definovaná žádná zásada, automatický upgrade operačního systému se vrátí k výchozím zásadám. | Bool |
RollingUpgradePolicy
Jméno | Popis | Hodnota |
---|---|---|
enableCrossZoneUpgrade | Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky. Pokud toto pole není nastavené, Azure Batch nenastaví výchozí hodnotu. Hodnota enableCrossZoneUpgrade na vytvořené VirtualMachineScaleSet bude rozhodnuto ve výchozích konfiguracích v VirtualMachineScaleSet. Toto pole je možné nastavit na hodnotu true nebo false pouze při použití NodePlacementConfiguration jako zónového pole. | Bool |
maxBatchInstancePercent | Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku v předchozích nebo budoucích dávkách, můžou způsobit snížení procenta instancí v dávce, aby se zajistila vyšší spolehlivost. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. | Int Omezení: Minimální hodnota = 5 Maximální hodnota = 100 |
maxUnhealthyInstancePercent | Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje před spuštěním jakékoli dávky. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. | Int Omezení: Minimální hodnota = 5 Maximální hodnota = 100 |
maxUnhealthyUpgradedInstancePercent | Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Hodnota tohoto pole by měla být v rozmezí od 0 do 100 (včetně). | Int Omezení: Minimální hodnota = 0 Maximální hodnota = 100 |
pauseTimeBetweenBatches | Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače v jedné dávce a spuštěním další dávky. Doba trvání by měla být zadána ve formátu ISO 8601. | řetězec |
prioritizeUnhealthyInstances | Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před všemi instancemi, které jsou v pořádku. | Bool |
rollbackFailedInstancesOnPolicyBreach | Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu | Bool |
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. Názvy můžou obsahovat libovolné znaky Unicode až do maximální délky 20. | string (povinné) |
heslo | Heslo pro uživatelský účet. | string (povinné) Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
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 Omezení: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
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 |
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í" |