Microsoft.MachineLearningServices workspaces/computes 2023-04-01

Artykuł
11/21/2024

Definicja zasobu Bicep

Typ zasobu obszary robocze/zasoby obliczeniowe można wdrożyć przy użyciu operacji docelowych:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.MachineLearningServices/workspaces/computes, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/computes@2023-04-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    computeLocation: 'string'
    description: 'string'
    disableLocalAuth: bool
    resourceId: 'string'
    computeType: 'string'
    // For remaining properties, see Compute objects
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Obiekty obliczeniowe

Ustaw właściwość computeType, aby określić typ obiektu.

W przypadku usługi AKSużyj:

{
  computeType: 'AKS'
  properties: {
    agentCount: int
    agentVmSize: 'string'
    aksNetworkingConfiguration: {
      dnsServiceIP: 'string'
      dockerBridgeCidr: 'string'
      serviceCidr: 'string'
      subnetId: 'string'
    }
    clusterFqdn: 'string'
    clusterPurpose: 'string'
    loadBalancerSubnet: 'string'
    loadBalancerType: 'string'
    sslConfiguration: {
      cert: 'string'
      cname: 'string'
      key: 'string'
      leafDomainLabel: 'string'
      overwriteExistingDomain: bool
      status: 'string'
    }
  }
}

W przypadku AmlComputeużyj:

{
  computeType: 'AmlCompute'
  properties: {
    enableNodePublicIp: bool
    isolatedNetwork: bool
    osType: 'string'
    propertyBag: any(Azure.Bicep.Types.Concrete.AnyType)
    remoteLoginPortPublicAccess: 'string'
    scaleSettings: {
      maxNodeCount: int
      minNodeCount: int
      nodeIdleTimeBeforeScaleDown: 'string'
    }
    subnet: {
      id: 'string'
    }
    userAccountCredentials: {
      adminUserName: 'string'
      adminUserPassword: 'string'
      adminUserSshPublicKey: 'string'
    }
    virtualMachineImage: {
      id: 'string'
    }
    vmPriority: 'string'
    vmSize: 'string'
  }
}

W przypadku ComputeInstanceużyj:

{
  computeType: 'ComputeInstance'
  properties: {
    applicationSharingPolicy: 'string'
    computeInstanceAuthorizationType: 'string'
    customServices: [
      {
        docker: {
          privileged: bool
        }
        endpoints: [
          {
            hostIp: 'string'
            name: 'string'
            protocol: 'string'
            published: int
            target: int
          }
        ]
        environmentVariables: {
          {customized property}: {
            type: 'string'
            value: 'string'
          }
        }
        image: {
          reference: 'string'
          type: 'string'
        }
        name: 'string'
        volumes: [
          {
            bind: {
              createHostPath: bool
              propagation: 'string'
              selinux: 'string'
            }
            consistency: 'string'
            readOnly: bool
            source: 'string'
            target: 'string'
            tmpfs: {
              size: int
            }
            type: 'string'
            volume: {
              nocopy: bool
            }
          }
        ]
      }
    ]
    enableNodePublicIp: bool
    personalComputeInstanceSettings: {
      assignedUser: {
        objectId: 'string'
        tenantId: 'string'
      }
    }
    schedules: {
      computeStartStop: [
        {
          action: 'string'
          cron: {
            expression: 'string'
            startTime: 'string'
            timeZone: 'string'
          }
          recurrence: {
            frequency: 'string'
            interval: int
            schedule: {
              hours: [
                int
              ]
              minutes: [
                int
              ]
              monthDays: [
                int
              ]
              weekDays: [
                'string'
              ]
            }
            startTime: 'string'
            timeZone: 'string'
          }
          schedule: {
            id: 'string'
            provisioningStatus: 'string'
            status: 'string'
          }
          status: 'string'
          triggerType: 'string'
        }
      ]
    }
    setupScripts: {
      scripts: {
        creationScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
        startupScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
      }
    }
    sshSettings: {
      adminPublicKey: 'string'
      sshPublicAccess: 'string'
    }
    subnet: {
      id: 'string'
    }
    vmSize: 'string'
  }
}

W przypadku DataFactoryużyj:

{
  computeType: 'DataFactory'
}

W przypadku DataLakeAnalyticsużyj:

{
  computeType: 'DataLakeAnalytics'
  properties: {
    dataLakeStoreAccountName: 'string'
  }
}

W przypadku usługi Databricksużyj:

{
  computeType: 'Databricks'
  properties: {
    databricksAccessToken: 'string'
    workspaceUrl: 'string'
  }
}

W przypadku usługi HDInsightużyj:

{
  computeType: 'HDInsight'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    sshPort: int
  }
}

W przypadku Kubernetes użyj:

{
  computeType: 'Kubernetes'
  properties: {
    defaultInstanceType: 'string'
    extensionInstanceReleaseTrain: 'string'
    extensionPrincipalId: 'string'
    instanceTypes: {
      {customized property}: {
        nodeSelector: {
          {customized property}: 'string'
        }
        resources: {
          limits: {
            {customized property}: 'string'
          }
          requests: {
            {customized property}: 'string'
          }
        }
      }
    }
    namespace: 'string'
    relayConnectionString: 'string'
    serviceBusConnectionString: 'string'
    vcName: 'string'
  }
}

W przypadku SynapseSpark użyj:

{
  computeType: 'SynapseSpark'
  properties: {
    autoPauseProperties: {
      delayInMinutes: int
      enabled: bool
    }
    autoScaleProperties: {
      enabled: bool
      maxNodeCount: int
      minNodeCount: int
    }
    nodeCount: int
    nodeSize: 'string'
    nodeSizeFamily: 'string'
    poolName: 'string'
    resourceGroup: 'string'
    sparkVersion: 'string'
    subscriptionId: 'string'
    workspaceName: 'string'
  }
}

W przypadku VirtualMachineużyj:

{
  computeType: 'VirtualMachine'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    isNotebookInstanceCompute: bool
    notebookServerPort: int
    sshPort: int
    virtualMachineSize: 'string'
  }
}

Wartości właściwości

Usługa AKS

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"AKS" (wymagane)
Właściwości	Właściwości usługi AKS	AKSSchemaProperties

AksNetworkingConfiguration

Nazwa	Opis	Wartość
dnsServiceIP	Adres IP przypisany do usługi DNS Kubernetes. Musi znajdować się w zakresie adresów usługi Kubernetes określonym w usłudze ServiceCidr.	struna Ograniczenia: Wzorzec = `^(?:(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)$`
dockerBridgeCidr	Zakres adresów IP notacji CIDR przypisany do sieci mostka platformy Docker. Nie może pokrywać się z żadnymi zakresami adresów IP podsieci ani zakresem adresów usługi Kubernetes.	struna Ograniczenia: Wzorzec = `^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$`
serviceCidr	Zakres adresów IP notacji CIDR, z którego chcesz przypisać adresy IP klastra usług. Nie może pokrywać się z żadnymi zakresami adresów IP podsieci.	struna Ograniczenia: Wzorzec = `^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$`
subnetId	Identyfikator zasobu podsieci sieci wirtualnej, do którego należą węzły obliczeniowe	struna

AKSSchemaProperties

Nazwa	Opis	Wartość
agentCount	Liczba agentów	Int Ograniczenia: Minimalna wartość = 0
agentVmSize	Rozmiar maszyny wirtualnej agenta	struna
aksNetworkingConfiguration	Konfiguracja sieci usługi AKS dla sieci wirtualnej	AksNetworkingConfiguration
clusterFqdn	Pełna kwalifikowana nazwa domeny klastra	struna
clusterPurpose	Zamierzone użycie klastra	"DenseProd" "DevTest" "FastProd"
loadBalancerSubnet	Podsieć modułu równoważenia obciążenia	struna
loadBalancerType	Typ modułu równoważenia obciążenia	"InternalLoadBalancer" "PublicIp"
sslConfiguration	Konfiguracja protokołu SSL	SslConfiguration

AmlCompute

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"AmlCompute" (wymagane)
Właściwości	Właściwości elementu AmlCompute	AmlComputeProperties

AmlComputeProperties

Nazwa	Opis	Wartość
enableNodePublicIp	Włączanie lub wyłączanie aprowizacji publicznego adresu IP węzła. Możliwe wartości to: Możliwe wartości to: true — wskazuje, że węzły obliczeniowe będą miały aprowizowane publiczne adresy IP. false — wskazuje, że węzły obliczeniowe będą miały prywatny punkt końcowy i nie będą mieć publicznych adresów IP.	Bool
isolatedNetwork	Sieć jest izolowana lub nie	Bool
osType	Typ systemu operacyjnego obliczeniowego	"Linux" "Windows"
propertyBag	Torba właściwości zawierająca dodatkowe właściwości.	dowolny
remoteLoginPortPublicAccess	Stan publicznego portu SSH. Możliwe wartości to: Wyłączone — wskazuje, że publiczny port SSH jest zamknięty we wszystkich węzłach klastra. Włączone — wskazuje, że publiczny port SSH jest otwarty we wszystkich węzłach klastra. NotSpecified — wskazuje, że publiczny port SSH jest zamknięty we wszystkich węzłach klastra, jeśli sieć wirtualna jest zdefiniowana, inne jest otwarte wszystkie węzły publiczne. Może to być ustawienie domyślne tylko w czasie tworzenia klastra, po jego utworzeniu zostanie włączone lub wyłączone.	"Wyłączone" "Włączone" "NotSpecified"
scaleSettings	Ustawienia skalowania dla obliczeń AML	ScaleSettings
podsieć	Identyfikator zasobu podsieci sieci wirtualnej, do którego należą węzły obliczeniowe.	ResourceId
userAccountCredentials	Poświadczenia dla konta użytkownika administratora, które zostanie utworzone w każdym węźle obliczeniowym.	UserAccountCredentials
virtualMachineImage	Obraz maszyny wirtualnej dla obliczeń AML — tylko okna	VirtualMachineImage
vmPriority	Priorytet maszyny wirtualnej	"Dedykowane" "LowPriority"
vmSize	Rozmiar maszyny wirtualnej	struna

Przypisany użytkownik

Nazwa	Opis	Wartość
objectId	Identyfikator obiektu usługi AAD użytkownika.	ciąg (wymagany)
tenantId	Identyfikator dzierżawy usługi AAD użytkownika.	ciąg (wymagany)

AutoPauseProperties

Nazwa	Opis	Wartość
delayInMinutes		Int
Włączone		Bool

AutoskalujWłaściwości

Nazwa	Opis	Wartość
Włączone		Bool
maxNodeCount		Int
minNodeCount		Int

BindOptions

Nazwa	Opis	Wartość
createHostPath	Wskaż, czy chcesz utworzyć ścieżkę hosta.	Bool
Propagacji	Typ opcji powiązania	struna
selinux	Wspomnij o opcjach selinux.	struna

Liczyć

Nazwa	Opis	Wartość
computeLocation	Lokalizacja bazowego środowiska obliczeniowego	struna
computeType	Ustaw wartość "AKS" dla typu AKS. Ustaw wartość "AmlCompute" dla typu AmlCompute. Ustaw wartość "ComputeInstance" dla typu ComputeInstance. Ustaw wartość "DataFactory" dla typu DataFactory. Ustaw wartość "DataLakeAnalytics" dla typu DataLakeAnalytics. Ustaw wartość "Databricks" dla typu Databricks. Ustaw wartość "HDInsight" dla typu HDInsight. Ustaw wartość "Kubernetes" dla typu Kubernetes. Ustaw wartość "SynapseSpark" dla typu SynapseSpark. Ustaw wartość "VirtualMachine" dla typu VirtualMachine.	"AKS" "AmlCompute" "ComputeInstance" "Databricks" "DataFactory" "DataLakeAnalytics" "HDInsight" "Kubernetes" "SynapseSpark" "VirtualMachine" (wymagane)
opis	Opis obliczeń usługi Machine Learning.	struna
disableLocalAuth	Rezygnacja z uwierzytelniania lokalnego i upewnienie się, że klienci mogą używać tylko tożsamości usługi zarządzanej i usługi AAD wyłącznie do uwierzytelniania.	Bool
resourceId	Identyfikator zasobu usługi ARM bazowego środowiska obliczeniowego	struna

ComputeInstance

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"ComputeInstance" (wymagane)
Właściwości	Właściwości klasy ComputeInstance	ComputeInstanceProperties

ComputeInstanceProperties

Nazwa	Opis	Wartość
applicationSharingPolicy	Zasady udostępniania aplikacji w tym wystąpieniu obliczeniowym wśród użytkowników nadrzędnego obszaru roboczego. Jeśli jest to osobiste, tylko twórca może uzyskiwać dostęp do aplikacji w tym wystąpieniu obliczeniowym. Po udostępnieniu dowolny użytkownik obszaru roboczego może uzyskiwać dostęp do aplikacji w tym wystąpieniu w zależności od przypisanej przez niego roli.	"Osobiste" "Udostępnione"
computeInstanceAuthorizationType	Typ autoryzacji wystąpienia obliczeniowego. Dostępne wartości to osobiste (wartość domyślna).	"osobiste"
customServices	Lista usług niestandardowych dodanych do obliczeń.	CustomService[]
enableNodePublicIp	Włączanie lub wyłączanie aprowizacji publicznego adresu IP węzła. Możliwe wartości to: Możliwe wartości to: true — wskazuje, że węzły obliczeniowe będą miały aprowizowane publiczne adresy IP. false — wskazuje, że węzły obliczeniowe będą miały prywatny punkt końcowy i nie będą mieć publicznych adresów IP.	Bool
personalComputeInstanceSettings	Ustawienia dla osobistego wystąpienia obliczeniowego.	PersonalComputeInstanceSettings
Harmonogramy	Lista harmonogramów, które mają być stosowane w obliczeniach.	ComputeSchedules
setupScripts	Szczegóły dostosowanych skryptów do wykonania w celu skonfigurowania klastra.	SetupScripts
sshSettings	Określa zasady i ustawienia dostępu SSH.	ComputeInstanceSshSettings
podsieć	Identyfikator zasobu podsieci sieci wirtualnej, do którego należą węzły obliczeniowe.	ResourceId
vmSize	Rozmiar maszyny wirtualnej	struna

ComputeInstanceSshSettings

Nazwa	Opis	Wartość
adminPublicKey	Określa plik klucza publicznego SSH rsa jako ciąg. Użyj polecenia "ssh-keygen -t rsa -b 2048", aby wygenerować pary kluczy SSH.	struna
sshPublicAccess	Stan publicznego portu SSH. Możliwe wartości to: Wyłączone — wskazuje, że publiczny port SSH jest zamknięty w tym wystąpieniu. Włączone — wskazuje, że publiczny port SSH jest otwarty i dostępny zgodnie z zasadami sieci wirtualnej/podsieci, jeśli ma to zastosowanie.	"Wyłączone" "Włączone"

ComputeResourceTags

Nazwa	Opis	Wartość

ComputeSchedules

Nazwa	Opis	Wartość
computeStartStop	Lista harmonogramów uruchamiania obliczeniowego, które mają być stosowane.	ComputeStartStopSchedule[]

ComputeStartStopSchedule

Nazwa	Opis	Wartość
akcja	[Wymagane] Akcja mocy obliczeniowej.	"Rozpocznij" "Zatrzymaj"
cron	Wymagane, jeśli parametr triggerType ma wartość Cron.	Cron
nawrót	Wymagane, jeśli parametr triggerType ma wartość Cykl.	Cykl
harmonogram	[Przestarzałe] Nie używać więcej.	ScheduleBase
stan	Czy harmonogram jest włączony, czy wyłączony?	"Wyłączone" "Włączone"
triggerType	[Wymagane] Typ wyzwalacza harmonogramu.	"Cron" "Cykl"

Cron

Nazwa	Opis	Wartość
wyrażenie	[Wymagane] Określa wyrażenie cron harmonogramu. Wyrażenie powinno być zgodne z formatem NCronTab.	struna
startTime	Czas rozpoczęcia w formacie rrrr-MM-ddTHH:mm:ss.	struna
strefa czasowa	Określa strefę czasową, w której jest uruchamiany harmonogram. Strefa czasowa powinna być zgodna z formatem strefy czasowej systemu Windows. Zobacz: /windows-hardware/manufacture/desktop/default-time-zones?view=windows-11	struna

CustomService

Nazwa	Opis	Wartość
doker	Opisuje ustawienia platformy Docker dla obrazu	Docker
Punkty końcowe	Konfigurowanie punktów końcowych dla kontenera	punkt końcowy[]
environmentVariables	Zmienna środowiskowa dla kontenera	CustomServiceEnvironmentVariables
obraz	Opis specyfikacji obrazów	Obraz
nazwa	Nazwa usługi niestandardowej	struna
Woluminów	Konfigurowanie woluminów dla kontenera	VolumeDefinition[]

CustomServiceEnvironmentVariables

Nazwa	Opis	Wartość

Databricks

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"Databricks" (wymagane)
Właściwości	Właściwości usługi Databricks	DatabricksProperties

DatabricksProperties

Nazwa	Opis	Wartość
databricksAccessToken	Token dostępu usługi Databricks	struna
workspaceUrl	Adres URL obszaru roboczego	struna

DataFactory

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"DataFactory" (wymagane)

DataLakeAnalytics

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"DataLakeAnalytics" (wymagane)
Właściwości		DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

Nazwa	Opis	Wartość
dataLakeStoreAccountName	Nazwa konta magazynu DataLake	struna

Doker

Nazwa	Opis	Wartość
uprzywilejowany	Określ, czy kontener działa w trybie uprzywilejowanym, czy nieuprzywilejowanym.	Bool

Punkt końcowy

Nazwa	Opis	Wartość
hostIp	Adres IP hosta, za pośrednictwem którego aplikacja jest uwidaczniona z kontenera	struna
nazwa	Nazwa punktu końcowego	struna
protokół	Protokół, za pośrednictwem którego komunikacja nastąpi za pośrednictwem tego punktu końcowego	"http" "tcp" "udp"
Opublikowany	Port, za pomocą którego aplikacja jest uwidaczniona z kontenera.	Int
cel	Port aplikacji wewnątrz kontenera.	Int

Zmienna środowiskowa

Nazwa	Opis	Wartość
typ	Typ zmiennej środowiskowej. Możliwe wartości to: local — dla zmiennej lokalnej	"local"
wartość	Wartość zmiennej środowiskowej	struna

HDInsight

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"HDInsight" (wymagane)
Właściwości	Właściwości obliczeniowe usługi HDInsight	HDInsightProperties

HdInsightProperties

Nazwa	Opis	Wartość
adres	Publiczny adres IP węzła głównego klastra.	struna
administratorKonto	Poświadczenia administratora dla węzła głównego klastra	VirtualMachineSshCredentials
sshPort	Port otwarty dla połączeń SSH w węźle głównym klastra.	Int

Obraz

Nazwa	Opis	Wartość
odniesienie	Dokumentacja obrazu	struna
typ	Typ obrazu. Możliwe wartości to: docker — w przypadku obrazów platformy Docker. azureml — w przypadku obrazów azureML	"azureml" "docker"

InstanceResourceSchema

Nazwa	Opis	Wartość

InstanceResourceSchema

Nazwa	Opis	Wartość

InstanceTypeSchema

Nazwa	Opis	Wartość
nodeSelector	Selektor węzła	InstanceTypeSchemaNodeSelector
zasoby	Żądania/limity zasobów dla tego typu wystąpienia	InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

Nazwa	Opis	Wartość

InstanceTypeSchemaResources

Nazwa	Opis	Wartość
Limity	Limity zasobów dla tego typu wystąpienia	InstanceResourceSchema
Żądania	Żądania zasobów dla tego typu wystąpienia	InstanceResourceSchema

Kubernetes

Nazwa	Opis	Wartość
computeType	Typ obliczeń	"Kubernetes" (wymagane)
Właściwości	Właściwości platformy Kubernetes	KubernetesProperties

KubernetesProperties

Nazwa	Opis	Wartość
defaultInstanceType	Domyślny typ wystąpienia	struna
extensionInstanceReleaseTrain	Szkolenie wydania wystąpienia rozszerzenia.	struna
extensionPrincipalId	Identyfikator podmiotu zabezpieczeń rozszerzenia.	struna
instanceTypes	Schemat typu wystąpienia	KubernetesPropertiesInstanceTypes
przestrzeń nazw	Przestrzeń nazw obliczeniowych	struna
relayConnectionString	Parametry połączenia przekaźnika.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.
serviceBusConnectionString	Parametry połączenia usługi ServiceBus.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.
vcName	Nazwa VC.	struna

KubernetesPropertiesInstanceTypes

Nazwa	Opis	Wartość

ManagedServiceIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).	"Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (wymagane)
userAssignedIdentities	Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.	UserAssignedIdentities