Erstellen einer Compute-Instanz von Azure Machine Learning

Artikel
09/03/2024

GILT FÜR:Azure CLI ML-Erweiterung v2 (aktuell)Python SDK azure-ai-ml v2 (aktuell)

Hier erfahren Sie, wie Sie eine Compute-Instanz in Ihrem Azure Machine Learning-Arbeitsbereich erstellen.

Nutzen Sie eine Compute-Instanz als Ihre vollständig konfigurierte und verwaltete Entwicklungsumgebung in der Cloud. Zu Entwicklungs- und Testzwecken können Sie die Instanz auch als Trainingscomputeziel verwenden. Computeinstanzen können mehrere Aufträge parallel ausführen und verfügen über eine Auftragswarteschlange. Da es sich bei einer Compute-Instanz um eine Entwicklungsumgebung handelt, kann diese nicht für andere in Ihrem Arbeitsbereich freigegeben werden.

In diesem Artikel erfahren Sie, wie Sie eine Compute-Instanz erstellen. Unter Verwalten einer Azure Machine Learning-Compute-Instanz finden Sie Schritte zum Verwalten des Startens, Beendens, Neustarts und Löschens einer Compute-Instanz.

Sie können auch ein Setupskript verwenden, um die Compute-Instanz mit Ihrer eigenen benutzerdefinierten Umgebung zu erstellen.

Sie können Aufträge sicher in einer virtuellen Netzwerkumgebung ausführen, ohne dass Unternehmen hierfür SSH-Ports öffnen müssen. Der Auftrag wird in einer Containerumgebung ausgeführt und packt die Abhängigkeiten Ihres Modells in einen Docker-Container.

Hinweis

In diesem Artikel wird in einigen Beispielen CLI v2 verwendet. Wenn Sie noch die CLI v1 verwenden, lesen Sie Erstellen eines Azure Machine Learning-Computeclusters (CLI v1).

Voraussetzungen

Ein Azure Machine Learning-Arbeitsbereich. Weitere Informationen finden Sie unter Erstellen eines Azure Machine Learning-Arbeitsbereichs. Im Speicherkonto muss die Option „Zugriff auf Speicherkontoschlüssel zulassen“ aktiviert sein, damit die Erstellung der Compute-Instanz erfolgreich ist.

Wählen Sie die Registerkarte für die verwendete Umgebung aus, um weitere Voraussetzungen anzuzeigen.

Um das Python SDK verwenden zu können, richten Sie Ihre Entwicklungsumgebung mit einem Arbeitsbereich ein. Sobald Ihre Umgebung eingerichtet ist, fügen Sie sie an den Arbeitsbereich in Ihrem Python-Skript an:

Führen Sie diesen Code aus, um eine Verbindung mit Ihrem Azure Machine Learning-Arbeitsbereich herzustellen.

Ersetzen Sie Ihre Abonnement-ID, den Namen der Ressourcengruppe und den Namen des Arbeitsbereichs im folgenden Code. So finden Sie diese Werte:

Melden Sie sich bei Azure Machine Learning Studio an.
Öffnen Sie den Arbeitsbereich, den Sie verwenden möchten.
Wählen Sie in der Azure Machine Learning Studio-Symbolleiste oben rechts den Namen Ihres Arbeitsbereichs aus.
Kopieren Sie den Wert für Arbeitsbereich, Ressourcengruppe und Abonnement-ID in den Code.

GILT FÜR: Python SDK azure-ai-ml v2 (aktuell)

# Enter details of your AML workspace
subscription_id = "<SUBSCRIPTION_ID>"
resource_group = "<RESOURCE_GROUP>"
workspace = "<AML_WORKSPACE_NAME>"

# get a handle to the workspace
from azure.ai.ml import MLClient
from azure.identity import DefaultAzureCredential

ml_client = MLClient(
    DefaultAzureCredential(), subscription_id, resource_group, workspace
)

ml_client ist ein Handler für den Arbeitsbereich, den Sie für die Verwaltung anderer Ressourcen und Aufträge verwenden.

Wenn Sie in einer Compute-Instanz arbeiten, ist die CLI bereits installiert. Wenn Sie auf einem anderen Computer arbeiten, installieren Sie die Azure CLI-Erweiterung für den Machine Learning-Dienst (v2).

Öffnen Sie ein Terminalfenster, und melden Sie sich bei Azure an. Wenn Sie eine Azure Machine Learning Compute-Instanz verwenden, führen Sie den folgenden Befehl aus:
```
az login --identity
```
Wenn Sie keine Compute-Instanz verwenden, lassen Sie --identity weg, und folgen Sie der Aufforderung, ein Browserfenster zur Authentifizierung zu öffnen.
Stellen Sie sicher, dass Sie über die neuesten Versionen der CLI und der Erweiterung ml verfügen:
```
az upgrade
```
Wenn Sie über mehrere Azure-Abonnements verfügen, legen Sie das aktive Abonnement auf das Abonnement fest, das Sie für Ihren Arbeitsbereich verwenden. (Sie können diesen Schritt überspringen, wenn Sie nur Zugriff auf ein einzelnes Abonnement haben.) Ersetzen Sie <YOUR_SUBSCRIPTION_NAME_OR_ID> durch den Namen oder die ID Ihres Abonnements. Entfernen Sie auch die Klammern <>.
```
az account set -s "<YOUR_SUBSCRIPTION_NAME_OR_ID>"
```
Legen Sie den Standardarbeitsbereich fest. Wenn Sie eine Compute-Instanz verwenden, können Sie den folgenden Befehl unverändert verwenden. Falls Sie einen anderen Computer verwenden, setzen Sie an den entsprechenden Stellen Ihren Ressourcengruppennamen und Arbeitsbereichsnamen ein. (Sie finden diese Werte in Azure Machine Learning Studio.)
```
az configure --defaults group=$CI_RESOURCE_GROUP workspace=$CI_WORKSPACE
```

Erstellen

Geschätzter Zeitaufwand: Ca. fünf Minuten.

Das Erstellen einer Compute-Instanz ist ein für Ihren Arbeitsbereich einmaliger Prozess. Sie können die Compute-Instanz als Entwicklungsarbeitsstation oder als Computeziel für das Training wiederverwenden. Sie können mehrere Compute-Instanzen an Ihren Arbeitsbereich anfügen.

Das Kontingent dedizierter Kerne pro Region pro VM-Familie und gesamte regionale Kontingent, das für die Erstellung von Compute-Instanzen gilt, ist einheitlich und wird mit dem Kontingent für Azure Machine Learning-Trainingcomputecluster gemeinsam genutzt. Das Beenden der Compute-Instanz gibt keine Kontingente frei. So wird sichergestellt, dass Sie die Compute-Instanz erneut starten können. Es ist nicht möglich, die Größe der VM einer Compute-Instanz zu ändern, nachdem sie erstellt wurde.

Der schnellste Weg, eine Compute-Instanz zu erstellen, ist die Anleitung Erstellen von Ressourcen, die Sie für den Einstieg benötigen.

Sie können auch die folgenden Beispiele verwenden, um eine Compute-Instanz mit weiteren Optionen zu erstellen:

GILT FÜR: Python SDK azure-ai-ml v2 (aktuell)

# Compute Instances need to have a unique name across the region.
# Here we create a unique name with current datetime
from azure.ai.ml.entities import ComputeInstance, AmlCompute
import datetime

ci_basic_name = "basic-ci" + datetime.datetime.now().strftime("%Y%m%d%H%M")
ci_basic = ComputeInstance(name=ci_basic_name, size="STANDARD_DS3_v2")
ml_client.begin_create_or_update(ci_basic).result()

Weitere Informationen zu den Klassen, Methoden und Parametern zum Erstellen einer Compute-Instanz finden Sie in den folgenden Referenzdokumenten:

GILT FÜR Azure CLI-ML-Erweiterung v2 (aktuell)

az ml compute create -f create-instance.yml

Hier finden Sie die Datei create-instance.yml:

$schema: https://azuremlschemas.azureedge.net/latest/computeInstance.schema.json 
name: basic-example-i
type: computeinstance
size: STANDARD_DS3_v2

Navigieren Sie zu Azure Machine Learning Studio.
Wählen Sie unter Verwalten die Option Compute aus.
Wählen Sie dieCompute-Instanzoben aus.
Wenn Sie keine Compute-Instanz haben, wählen Sie Erstellen in der Mitte der Seite aus.
Wenn eine Liste der Computeressourcen angezeigt wird, wählen Sie oberhalb der Liste + Neu aus.

Füllen Sie das Formular aus:

Screenshot: Erforderliche Einträge im Formular

Feld	BESCHREIBUNG
Computename	– Der Name ist erforderlich und muss zwischen 3 und 24 Zeichen lang sein. – Zulässige Zeichen sind Groß- und Kleinbuchstaben, Ziffern und das Zeichen -. – Der Name muss mit einem Buchstaben beginnen. – Der Name muss auf allen vorhandenen Compute-Instanzen innerhalb einer Azure-Region eindeutig sein. Es wird eine Warnung angezeigt, wenn der von Ihnen gewählte Name nicht eindeutig ist. – Wenn ein Zeichen - verwendet wird, muss darauf im Namen mindestens ein Buchstabe folgen.
Typ des virtuellen Computers	Wählen Sie CPU oder GPU aus. Dieser Typ kann nach der Erstellung nicht mehr geändert werden.
Größe des virtuellen Computers	Die Größe der unterstützten virtuellen Computer kann in Ihrer Region eingeschränkt sein. Überprüfen Sie die Verfügbarkeitsliste.

Wählen Sie Überprüfen + Erstellen, es sei denn, Sie möchten erweiterte Einstellungen für die Compute-Instanz konfigurieren.
Wählen Sie Weiter aus, um zur Zeitplanung zu wechseln, wenn Sie ein regelmäßiges Starten und Beenden der Compute-Instanz planen möchten. Weitere Informationen finden Sie in den Abschnitten zum Aktivieren des Herunterfahrens bei Leerlauf und zum Hinzufügen eines Zeitplans.
Wählen Sie Sicherheit aus, wenn Sie Sicherheitseinstellungen wie SSH, virtuelles Netzwerk, Stammzugriff und verwaltete Identität für Ihre Compute-Instanz konfigurieren möchten. Verwenden Sie diesen Abschnitt für Folgendes:
- Den Computer einem anderen Benutzer zuweisen. Weitere Informationen zur Zuweisung an andere Benutzer finden Sie unter Erstellen im Namen von.
- Zuweisen einer verwalteten Identität. Weitere Informationen finden Sie unter Zuweisen einer verwalteten Identität.
- Aktivieren vom SSH-Zugang. Folgen Sie den ausführlichen Anweisungen für den SSH-Zugriff.
- Aktivieren Sie ein virtuelles Netzwerk:
  - Wenn Sie ein Azure Virtual Network verwenden, geben Sie die Ressourcengruppe, das virtuelle Netzwerk und das Subnetz an, um die Compute-Instanz in einem Azure Virtual Network zu erstellen. Sie können auch Keine öffentliche IP-Adresse auswählen, um die Erstellung einer öffentlichen IP-Adresse zu verhindern, die einen Private Link-Arbeitsbereich erfordert. Sie müssen diese Netzwerkanforderungen auch für die Einrichtung virtueller Netzwerke erfüllen.
  - Wenn Sie ein verwaltetes virtuelles Azure Machine Learning-Netzwerk verwenden, wird die Compute-Instanz innerhalb des verwalteten virtuellen Netzwerks erstellt. Sie können auch Keine öffentliche IP-Adresse auswählen, um die Erstellung einer öffentlichen IP-Adresse zu verhindern. Weitere Informationen finden Sie unter Verwaltete Computeressource mit einem verwalteten Netzwerk.
Wählen Sie Anwendungen aus, wenn Sie benutzerdefinierte Anwendungen, die in Ihrer Compute-Instanz verwendet werden sollen, hinzufügen möchten, z. B. RStudio oder Posit Workbench. Weitere Informationen finden Sie unter Hinzufügen benutzerdefinierter Anwendungen wie RStudio oder Posit Workbench.
Wählen Sie Tags aus, wenn Sie zusätzliche Informationen zum Kategorisieren der Compute-Instanz hinzufügen möchten.
Wählen Sie Überprüfen und erstellen aus, um Ihre Einstellungen zu überprüfen.
Nachdem Sie die Einstellungen überprüft haben, wählen Sie Erstellen aus, um die Compute-Instanz zu erstellen.

Sie können eine Compute-Instanz auch mit einer Azure Resource Manager-Vorlage erstellen.

Konfigurieren des Herunterfahrens bei Leerlauf

Sie können verhindern, dass Ihnen Kosten für eine aktivierte, aber inaktive Compute-Instanz in Rechnung gestellt werden, indem Sie konfigurieren, wann Ihre Compute-Instanz bei Inaktivität heruntergefahren werden soll.

Eine Compute-Instanz wird als inaktiv betrachtet, wenn die folgenden Bedingungen erfüllt sind:

Keine aktiven Jupyter-Kernelsitzungen (das heißt, keine Notebooknutzung über Jupyter-, JupyterLab- oder Interactive-Notebooks)
Keine aktiven Jupyter-Terminalsitzungen
Keine aktiven Azure Machine Learning-Ausführungen oder -Experimente
Keine VS Code-Verbindungen. Sie müssen Ihre VS Code-Verbindung für Ihre Compute-Instanz schließen, damit diese als inaktiv betrachtet wird. Sitzungen werden automatisch beendet, wenn VS Code drei Stunden lang keine Aktivität erkennt.
Auf der Compute-Instanz werden keine benutzerdefinierten Anwendungen ausgeführt.

Eine Compute-Instanz wird nicht als inaktiv betrachtet, wenn eine benutzerdefinierte Anwendung ausgeführt wird. Um eine Compute-Instanz mit einer benutzerdefinierten Anwendung automatisch herunterzufahren, muss ein Zeitplan eingerichtet werden, oder die benutzerdefinierte Anwendung muss entfernt werden. Es gibt auch einige grundlegende Grenzen für Inaktivitätszeiten. Die Compute-Instanz muss für mindestens 15 Minuten und maximal drei Tage inaktiv sein. Außerdem verfolgen wir VS Code SSH-Verbindungen nicht nach, um Aktivitäten zu ermitteln.

Wenn eine Compute-Instanz bereits für eine bestimmte Zeit im Leerlauf war und die Einstellungen für das Herunterfahren im Leerlauf auf einen Zeitraum aktualisiert werden, der kürzer als die aktuelle Leerlaufdauer ist, wird die Leerlaufzeit zudem auf 0 zurückgesetzt. Wenn sich die Compute-Instanz beispielsweise bereits 20 Minuten im Leerlauf befindet und die Einstellungen für das Herunterfahren auf 15 Minuten aktualisiert werden, wird die Leerlaufzeit auf 0 zurückgesetzt.

Wichtig

Wenn die Compute-Instanz auch mit einer verwalteten Identität konfiguriert ist, wird die Compute-Instanz nicht aufgrund von Inaktivität heruntergefahren, es sei denn, die verwaltete Identität hat Mitwirkenden-Zugriff auf den Azure Machine Learning-Arbeitsbereich. Weitere Informationen zu Zugriffsberechtigungen finden Sie unter Verwalten des Zugriffs auf einen Azure Machine Learning-Arbeitsbereich.

Die Einstellung kann während der Erstellung einer Compute-Instanz oder für vorhandene Compute-Instanzen über die folgenden Schnittstellen konfiguriert werden:

GILT FÜR: Python SDK azure-ai-ml v2 (aktuell)

Fügen Sie beim Erstellen einer neuen Compute-Instanz den Parameter idle_time_before_shutdown_minutes hinzu.

# Note that idle_time_before_shutdown has been deprecated.
ComputeInstance(name=ci_basic_name, size="STANDARD_DS3_v2", idle_time_before_shutdown_minutes="30")

Sie können die Leerlaufzeit einer vorhandenen Compute-Instanz nicht mit dem Python SDK ändern.

GILT FÜR Azure CLI-ML-Erweiterung v2 (aktuell)

Fügen Sie beim Erstellen einer neuen Compute-Instanz idle_time_before_shutdown_minutes zur YAML-Definition hinzu.

# Note that this is just a snippet for the idle shutdown property. Refer to the "Create" Azure CLI section for more information.
# Note that idle_time_before_shutdown has been deprecated.
idle_time_before_shutdown_minutes: 30

Sie können die Leerlaufzeit einer vorhandenen Compute-Instanz nicht über die CLI ändern.

Sie können die Leerlaufzeit auch wie folgt ändern:

REST-API

Endpunkt:

POST https://management.azure.com/subscriptions/{SUB_ID}/resourceGroups/{RG_NAME}/providers/Microsoft.MachineLearningServices/workspaces/{WS_NAME}/computes/{CI_NAME}/updateIdleShutdownSetting?api-version=2021-07-01

Hauptteil:

{
    "idleTimeBeforeShutdown": "PT30M" // this must be a string in ISO 8601 format
}

ARM-Vorlagen: Nur konfigurierbar während der Erstellung einer neuen Compute-Instanz

// Note that this is just a snippet for the idle shutdown property in an ARM template
{
    "idleTimeBeforeShutdown":"PT30M" // this must be a string in ISO 8601 format
}

Planen des automatischen Startens und Beendens

Definieren Sie mehrere Zeitpläne für automatisches Herunterfahren und automatisches Starten. Erstellen Sie beispielsweise einen Zeitplan, der von Montag bis Donnerstag um 9 Uhr morgens beginnt und um 18 Uhr endet, und einen zweiten Zeitplan, der um 9 Uhr morgens beginnt und um 16 Uhr endet, für Freitag. Sie können insgesamt vier Zeitpläne pro Compute-Instanz erstellen.

Zeitpläne können auch für Erstellen im Namen von Compute-Instanzen definiert werden. Sie können einen Zeitplan erstellen, mit dem die Compute-Instanz im angehaltenen Zustand erstellt wird. Angehaltene Compute-Instanzen sind nützlich, wenn Sie eine Compute-Instanz im Namen eines anderen Benutzers erstellen.

Vor einem geplanten Herunterfahren wird Benutzer*innen eine Benachrichtigung angezeigt, die sie darüber informiert, dass die Compute-Instanz in Kürze heruntergefahren wird. An diesem Punkt können die Benutzer*innen das bevorstehende Herunterfahren verwerfen, wenn sie z. B. ihre Compute-Instanz gerade verwenden.

Erstellen eines Zeitplans

GILT FÜR: Python SDK azure-ai-ml v2 (aktuell)

from azure.ai.ml.entities import ComputeInstance, ComputeSchedules, ComputeStartStopSchedule, RecurrenceTrigger, RecurrencePattern
from azure.ai.ml.constants import TimeZone
from azure.ai.ml import MLClient
from azure.identity import DefaultAzureCredential

ci_minimal_name = "ci-name"
ci_start_time = "2023-06-21T11:47:00" #specify your start time in the format yyyy-mm-ddThh:mm:ss

rec_trigger = RecurrenceTrigger(start_time=ci_start_time, time_zone=TimeZone.INDIA_STANDARD_TIME, frequency="week", interval=1, schedule=RecurrencePattern(week_days=["Friday"], hours=15, minutes=[30]))
myschedule = ComputeStartStopSchedule(trigger=rec_trigger, action="start")
com_sch = ComputeSchedules(compute_start_stop=[myschedule])

my_compute = ComputeInstance(name=ci_minimal_name, schedules=com_sch)
ml_client.compute.begin_create_or_update(my_compute)

GILT FÜR Azure CLI-ML-Erweiterung v2 (aktuell)

az ml compute create -f create-instance.yml

Hier finden Sie die Datei create-instance.yml:

$schema: https://azuremlschemas.azureedge.net/latest/computeInstance.schema.json 
name: schedule-example-i
type: computeinstance
size: STANDARD_DS3_v2
schedules:
   compute_start_stop:
      - action: stop
        trigger:
         type: cron
         start_time: "2021-03-10T21:21:07"
         time_zone: Pacific Standard Time
         expression: 0 18 * * *

Erstellen eines Zeitplans mithilfe einer Resource Manager-Vorlage

Sie können den automatischen Start und Stopp einer Compute-Instanz planen, indem Sie eine Ressourcenmanager-Vorlage verwenden.

Fügen Sie in der Ressourcenmanager-Vorlage hinzu:

"schedules": "[parameters('schedules')]"

Verwenden Sie dann entweder cron- oder LogicApps-Ausdrücke, um den Zeitplan für das Starten oder Stoppen der Instanz in Ihrer Parameterdatei zu definieren:

  "schedules": {
    "value": {
      "computeStartStop": [
        {
          "triggerType": "Cron",
          "cron": {
            "timeZone": "UTC",
            "expression": "0 18 * * *"
          },
          "action": "Stop",
          "status": "Enabled"
        },
        {
          "triggerType": "Cron",
          "cron": {
            "timeZone": "UTC",
            "expression": "0 8 * * *"
          },
          "action": "Start",
          "status": "Enabled"
        },
        {
          "triggerType": "Recurrence",
          "recurrence": {
            "frequency": "Day",
            "interval": 1,
            "timeZone": "UTC",
            "schedule": {
              "hours": [17],
              "minutes": [0]
            }
          },
          "action": "Stop",
          "status": "Enabled"
        }
      ]
    }
  }

Die Aktion kann den Wert Start oder Stop aufweisen.
Für den Auslösertyp Recurrence verwenden Sie dieselbe Syntax wie für LogicApps mit diesem -Serienschema.

Für den Auslösertyp cron verwenden Sie die Standard-Cron-Syntax:

// Crontab expression format: 
// 
// * * * * * 
// - - - - - 
// | | | | | 
// | | | | +----- day of week (0 - 6) (Sunday=0) 
// | | | +------- month (1 - 12) 
// | | +--------- day of month (1 - 31) 
// | +----------- hour (0 - 23) 
// +------------- min (0 - 59) 
// 
// Star (*) in the value field above means all legal values as in 
// braces for that column. The value column can have a * or a list 
// of elements separated by commas. An element is either a number in 
// the ranges shown above or two numbers in the range separated by a 
// hyphen (meaning an inclusive range).

Azure Policy-Unterstützung zur Vorgabe eines Zeitplans

Verwenden Sie die Azure-Policy, um für jede Compute-Instanz in einem Abonnement einen Zeitplan für das Herunterfahren zu erzwingen, oder verwenden Sie standardmäßig einen Zeitplan, wenn nichts vorhanden ist. Nachfolgend finden Sie ein Beispiel für eine Richtlinie, die das Herunterfahren um 22.00 Uhr PST vorsieht.

{
    "mode": "All",
    "policyRule": {
     "if": {
      "allOf": [
       {
        "field": "Microsoft.MachineLearningServices/workspaces/computes/computeType",
        "equals": "ComputeInstance"
       },
       {
        "field": "Microsoft.MachineLearningServices/workspaces/computes/schedules",
        "exists": "false"
       }
      ]
     },
     "then": {
      "effect": "append",
      "details": [
       {
        "field": "Microsoft.MachineLearningServices/workspaces/computes/schedules",
        "value": {
         "computeStartStop": [
          {
           "triggerType": "Cron",
           "cron": {
            "startTime": "2021-03-10T21:21:07",
            "timeZone": "Pacific Standard Time",
            "expression": "0 22 * * *"
           },
           "action": "Stop",
           "status": "Enabled"
          }
         ]
        }
       }
      ]
     }
    }
}

Erstellen im Namen von

Als Administrator können Sie im Namen einer wissenschaftlichen Fachkraft für Daten eine Compute-Instanz erstellen und ihr die Instanz mit der folgenden Methode zuweisen:

Studio mit den Sicherheitseinstellungen aus diesem Artikel.
Azure Resource Manager-Vorlage. Ausführliche Informationen zum Suchen der in dieser Vorlage benötigten „TenantID“ und „ObjectID“ finden Sie unter Ermitteln von Identitätsobjekt-IDs für die Authentifizierungskonfiguration. Diese Werte finden Sie auch im Microsoft Entra Admin Center.

Um die Sicherheit weiter zu verbessern, wird beim Erstellen einer Compute-Instanz im Namen der wissenschaftlichen Fachkraft für Daten und Zuweisen der Instanz an diese das einmalige Anmelden (Single Sign-On, SSO) deaktiviert, wenn die Compute-Instanz über ein Setupskript oder eine benutzerdefinierte App verfügt.

Der Benutzer mit der Zuweisung muss SSO für die Compute-Instanz selbst aktivieren, nachdem ihm diese zugewiesen wurde, indem er die SSO-Einstellung für die Compute-Instanz aktualisiert. Der Benutzer muss die folgende Berechtigung/Aktion in seiner Rolle MachineLearningServices/workspaces/computes/enableSso/actionhaben. „Zugewiesen an“-Benutzer benötigen keine Computeschreibberechtigung (Erstellen), um SSO zu aktivieren.

Hier sind die Schritte, die der Benutzer mit der Zuweisung durchführen muss. Beachten Sie, dass der Ersteller der Compute-Instanz aufgrund von Sicherheitsgründen nicht berechtigt ist, SSO für diese zu aktivieren.

Klicken Sie im linken Navigationsbereich in Azure Machine Learning Studio auf „Compute“.
Klicken Sie auf den Namen der Compute-Instanz, in der Sie SSO aktivieren müssen.
Bearbeiten Sie den Detailabschnitt für einmaliges Anmelden.
Aktivieren Sie den Umschalter für einmaliges Anmelden.
Speichern Sie sie. Das Aktualisieren dauert einige Zeit.

Zuweisen einer verwalteten Identität

Sie können einer Compute-Instanz eine system- oder benutzerseitig zugewiesene verwaltete Identität zuweisen, um sich gegenüber anderen Azure-Ressourcen wie einem Speicher zu authentifizieren. Die Verwendung von verwalteten Identitäten für die Authentifizierung trägt zur Verbesserung der Sicherheit und Verwaltung des Arbeitsbereichs bei. Sie können z. B. Benutzern den Zugriff auf Trainingsdaten nur gestatten, wenn sie bei einer Compute-Instanz angemeldet sind. Oder verwenden Sie eine gemeinsame benutzerseitig zugewiesene verwaltete Identität, um den Zugriff auf ein bestimmtes Speicherkonto zu ermöglichen.

Wichtig

Wenn die Compute-Instanz auch für Herunterfahren im Leerlauf konfiguriert ist, wird die Compute-Instanz nicht aufgrund von Inaktivität heruntergefahren, es sei denn, die verwaltete Identität hat Mitwirkenden-Zugriff auf den Azure Machine Learning-Arbeitsbereich. Weitere Informationen zu Zugriffsberechtigungen finden Sie unter Verwalten des Zugriffs auf einen Azure Machine Learning-Arbeitsbereich.

Verwenden Sie das SDK V2, um eine Compute-Instanz mit systemseitig zugewiesener verwalteter Identität zu erstellen:

from azure.ai.ml import MLClient
from azure.identity import ManagedIdentityCredential
client_id = os.environ.get("DEFAULT_IDENTITY_CLIENT_ID", None)
credential = ManagedIdentityCredential(client_id=client_id)
ml_client = MLClient(credential, subscription_id, resource_group, workspace)

Sie können auch SDK V1 verwenden:

from azureml.core.authentication import MsiAuthentication
from azureml.core import Workspace
client_id = os.environ.get("DEFAULT_IDENTITY_CLIENT_ID", None)
auth = MsiAuthentication(identity_config={"client_id": client_id})
workspace = Workspace.get("chrjia-eastus", auth=auth, subscription_id=subscription_id, resource_group=resource_group, location="East US")

Verwenden Sie die V2 CLI, um eine Compute-Instanz mit systemseitig zugewiesener verwalteter Identität zu erstellen:

az ml compute create --name myinstance --identity-type SystemAssigned --type ComputeInstance --resource-group my-resource-group --workspace-name my-workspace

Sie können auch die V2 CLI mit YAML-Datei verwenden, z. B. um eine Compute-Instanz mit einer benutzerseitig zugewiesenen verwalteten Identität zu erstellen:

Azure Machine Learning compute create --file compute.yaml --resource-group my-resource-group --workspace-name my-workspace

Die Identitätsdefinition ist in der Datei „compute.yaml“ enthalten:

https://azuremlschemas.azureedge.net/latest/computeInstance.schema.json
name: myinstance
type: computeinstance
identity:
  type: user_assigned
  user_assigned_identities:
    - resource_id: identity_resource_id

Nachdem die verwaltete Identität erstellt wurde, erteilen Sie der verwalteten Identität mindestens die Rolle „Storage-Blobdatenleser“ für das Speicherkonto des Datenspeichers. Weitere Informationen finden Sie unter Zugreifen auf Speicherdienste. Wenn Sie dann an der Compute-Instanz arbeiten, wird die verwaltete Identität automatisch zur Authentifizierung bei Datenspeichern verwendet.

Hinweis

Der Name der erstellten systemseitig verwalteten Identität hat in Microsoft Entra ID dieses Format: /workspace-name/computes/compute-instance-name.

Sie können die verwaltete Identität auch manuell zur Authentifizierung bei anderen Azure-Ressourcen verwenden. Das folgende Beispiel zeigt, wie Sie es verwenden, um ein Azure Resource Manager-Zugriffstoken abzurufen:

import requests

def get_access_token_msi(resource):
    client_id = os.environ.get("DEFAULT_IDENTITY_CLIENT_ID", None)
    resp = requests.get(f"{os.environ['MSI_ENDPOINT']}?resource={resource}&clientid={client_id}&api-version=2017-09-01", headers={'Secret': os.environ["MSI_SECRET"]})
    resp.raise_for_status()
    return resp.json()["access_token"]

arm_access_token = get_access_token_msi("https://management.azure.com")

Wenn Sie die Azure CLI mit der verwalteten Identität für die Authentifizierung verwenden möchten, geben Sie bei der Anmeldung die Client-ID der Identität als Benutzernamen an:

az login --identity --username $DEFAULT_IDENTITY_CLIENT_ID

Hinweis

Sie können azcopy nicht verwenden, wenn Sie versuchen, eine verwaltete Identität zu verwenden. azcopy login --identity funktioniert nicht.

Aktivieren des SSH-Zugriffs

Der SSH-Zugriff ist standardmäßig deaktiviert. Der SSH-Zugriff kann nach der Erstellung nicht aktiviert oder deaktiviert werden. Stellen Sie sicher, dass Sie den Zugriff aktivieren, wenn Sie vorhaben, interaktiv mit VS Code Remote zu debuggen.

Nach Auswahl von Weiter: Erweiterte Einstellungen:

Aktivieren Sie die Option SSH-Zugriff aktivieren.
Wählen Sie als Quelle für öffentlichen SSH-Schlüssel eine der folgenden Optionen in der Dropdownliste aus:
- Bei Verwendung von Neues Schlüsselpaar generieren:
  1. Geben Sie in Name des Schlüsselpaars einen Namen für den Schlüssel ein.
  2. Klicken Sie auf Erstellen.
  3. Wählen Sie Privaten Schlüssel herunterladen und Computeressource erstellen aus. Der Schlüssel wird üblicherweise in den Ordner Downloads heruntergeladen.
- Wenn Sie In Azure vorhandenen öffentlichen Schlüssel verwenden auswählen, suchen Sie unter Gespeicherter Schlüssel nach dem Schlüssel, und wählen Sie ihn aus.
- Wenn Sie Vorhandenen öffentlichen Schlüssel verwenden auswählen, geben Sie einen öffentlichen RSA-Schlüssel im einzeiligen Format (beginnend mit „ssh-rsa“) oder im mehrzeiligen PEM-Format an. Sie können die SSH-Schlüssel mithilfe von „ssh-keygen“ unter Linux und OS X oder mit PuTTYGen unter Windows generieren.

Einrichten eines SSH-Schlüssels zu einem späteren Zeitpunkt

Obwohl SSH nach der Erstellung nicht aktiviert oder deaktiviert werden kann, haben Sie die Möglichkeit, einen SSH-Schlüssel auf einer SSH-fähigen Compute-Instanz zu einem späteren Zeitpunkt einzurichten. Dadurch können Sie den SSH-Schlüssel nach der Erstellung einrichten. Aktivieren Sie dazu SSH auf Ihrer Compute-Instanz, und wählen Sie „Später einen SSH-Schlüssel einrichten” als öffentliche SSH-Schlüsselquelle aus. Nachdem die Compute-Instanz erstellt wurde, können Sie die Detailseite Ihrer Compute-Instanz besuchen und auswählen, dass Sie Ihre SSH-Schlüssel bearbeiten möchten. An dieser Stelle können Sie Ihren SSH-Schlüssel hinzufügen.

Ein Beispiel für einen häufigen Anwendungsfall hierfür ist das Erstellen einer Compute-Instanz im Namen anderer Benutzer*innen (siehe Erstellen im Auftrag von). Wenn Sie eine Compute-Instanz im Namen anderer Benutzer*innen bereitstellen, können Sie SSH für die neuen Besitzer*innen der Compute-Instanz aktivieren, indem Sie Später einen SSH-Schlüssel einrichten auswählen. Die neuen Besitzer*innen der Compute-Instanz können dadurch für die neue Compute-Instanz einen SSH-Schlüssel einrichten, sobald die Compute-Instanz gemäß den oben beschriebenen Schritten erstellt und zugewiesen wurde.

Verbinden mit SSH

Nachdem Sie eine Compute mit aktiviertem SSH-Zugriff erstellt haben, verwenden Sie diese Schritte für den Zugriff.

Suchen Sie die Computeressourcen in Ihren Arbeitsbereichsressourcen:
1. Wählen Sie links Compute aus.
2. Verwenden Sie die Registerkarten oben, um Compute-Instanz oder Computecluster für die Suche nach Ihrem Computer auszuwählen.
Wählen Sie den Namen der Computeressource in der Liste der Ressourcen aus.
Suchen Sie die Verbindungszeichenfolge:
- Wählen Sie für eine Compute-Instanz die Option Verbinden am oberen Rand des Abschnitts Details aus.
- Wählen Sie für einen Compute-Cluster oben die Option Knoten und dann in der Tabelle die Verbindungszeichenfolge für Ihren Knoten aus.
Kopieren Sie die Verbindungszeichenfolge.
Unter Windows öffnen Sie PowerShell oder eine Eingabeaufforderung:
1. Wechseln Sie in das Verzeichnis oder den Ordner, in dem Ihr Schlüssel gespeichert ist.
2. Fügen Sie der Verbindungszeichenfolge das Flag „-i“ hinzu, um den privaten Schlüssel zu finden und auf seinen Speicherort zu verweisen:
  
  ssh -i <keyname.pem> azureuser@... (rest of connection string)
Führen Sie für Linux-Benutzer die Schritte unter Erstellen und Verwenden eines SSH-Schlüsselpaars für virtuelle Linux-Computer in Azure aus.
Für die SCP-Verwendung:

scp -i key.pem -P {port} {fileToCopyFromLocal } azureuser@yourComputeInstancePublicIP:~/{destination}

REST-API

Die wissenschaftliche Fachkraft für Daten, für die Sie die Compute-Instanz erstellen, benötigt die folgenden Azure RBAC-Berechtigungen (rollenbasierte Zugriffssteuerung in Azure):

Microsoft.MachineLearningServices/workspaces/computes/start/action
Microsoft.MachineLearningServices/workspaces/computes/stop/action
Microsoft.MachineLearningServices/workspaces/computes/restart/action
Microsoft.MachineLearningServices/workspaces/computes/applicationaccess/action
Microsoft.MachineLearningServices/workspaces/computes/updateSchedules/action

Die wissenschaftliche Fachkraft für Daten kann die Compute-Instanz starten, beenden und neu starten. Sie kann die Compute-Instanz für folgende Zwecke verwenden:

Jupyter
JupyterLab
RStudio
Posit Workbench (früher RStudio Workbench)
Integrierte Notebooks

Hinzufügen benutzerdefinierter Anwendungen wie RStudio oder Posit Workbench

Sie können beim Erstellen einer Compute-Instanz andere Anwendungen einrichten, z. B. RStudio oder Posit Workbench (früher RStudio Workbench). Führen Sie die folgenden Schritte in Studio aus, um eine benutzerdefinierte Anwendung auf Ihrer Compute-Instanz einzurichten.

Ausfüllen des Formulars zum Erstellen einer neuen Compute-Instanz
Wählen Sie Anwendungen aus.
Wählen Sie Anwendung hinzufügen aus.

Screenshot: Einrichten eines benutzerdefinierten Diensts

Einrichten von Posit Workbench (früher RStudio Workbench)

RStudio ist eine der beliebtesten IDEs unter R-Entwicklern für ML- und Data Science-Projekte. Sie können Posit Workbench (eine Entwicklungsumgebung, die Zugriff auf RStudio und andere Entwicklungstools bietet) ganz einfach mit Ihrer eigenen Posit-Lizenz zur Ausführung auf Ihrer Compute-Instanz einrichten und auf die umfangreichen Features von Posit Workbench zugreifen.

Befolgen Sie beim Erstellen Ihrer Compute-Instanz die oben aufgeführten Schritte zum Hinzufügen von Anwendungen.
Wählen Sie im Dropdownmenü Anwendung die Option Posit Workbench (Bring Your Own License) aus, und geben Sie Ihren Posit Workbench-Lizenzschlüssel in das Feld Lizenzschlüssel ein. Sie erhalten Ihre Posit Workbench-Lizenz oder Testlizenz von Posit.
Klicken Sie auf Erstellen, um die Posit Workbench-Anwendung Ihrer Compute-Instanz hinzuzufügen.

Wichtig

Wenn Sie einen Arbeitsbereich mit einer privaten Verbindung verwenden, stellen Sie sicher, dass das Docker-Image, „pkg-containers.githubusercontent.com“ und „ghcr.io“ zugänglich sind. Verwenden Sie zudem einen veröffentlichten Port im Bereich 8704–8993. Stellen Sie bei Verwendung von Posit Workbench (früher RStudio Workbench) sicher, dass auf die Lizenz zugegriffen werden kann, indem Sie Netzwerkzugriff auf https://www.wyday.com bereitstellen.

Hinweis

Die Unterstützung für den Zugriff auf den Dateispeicher Ihres Arbeitsbereichs über Posit Workbench ist noch nicht verfügbar.
Wenn Sie auf mehrere Instanzen von Posit Workbench zugreifen, verwenden Sie bei der Anzeige des Fehlers „400 – Ungültige Anforderung. Anforderungsheader oder Cookie zu groß“ einen neuen Browser, oder greifen Sie über einen Browser im Inkognito-Modus zu.

Einrichten von RStudio (Open Source)

Um RStudio zu verwenden, richten Sie wie folgt eine benutzerdefinierte Anwendung ein:

Befolgen Sie beim Erstellen Ihrer Compute-Instanz die oben aufgeführten Schritte zum Hinzufügen von Anwendungen.
Wählen Sie in der Dropdownliste Anwendung die Option Benutzerdefinierte Anwendung aus.
Konfigurieren Sie in Anwendungsname den gewünschten Namen für die Anwendung.
Richten Sie die Anwendung zur Ausführung auf Zielport 8787 ein. Das unten aufgeführte Docker-Image für RStudio (Open Source) muss auf diesem Zielport ausgeführt werden.
Richten Sie die Anwendung für den Zugriff über den Veröffentlichungsport 8787 ein. Bei Bedarf können Sie die Anwendung für den Zugriff über einen anderen Veröffentlichungsport konfigurieren.
Verweisen Sie das Docker-Image an ghcr.io/azure/rocker-rstudio-ml-verse:latest.
Wählen Sie Erstellen aus, um RStudio als benutzerdefinierte Anwendung auf Ihrer Compute-Instanz einzurichten.

Wichtig

Einrichten weiterer benutzerdefinierter Anwendungen

Richten Sie weitere benutzerdefinierte Anwendungen auf Ihrer Compute-Instanz ein, indem Sie die Anwendung in einem Docker-Image bereitstellen.

Befolgen Sie beim Erstellen Ihrer Compute-Instanz die oben aufgeführten Schritte zum Hinzufügen von Anwendungen.
Wählen Sie im Dropdownmenü Benutzerdefinierte Anwendung die Option Benutzerdefinierte Anwendung aus.
Konfigurieren Sie einen Wert für Anwendungsname, den Zielport, über den Sie die Anwendung ausführen möchten, den Veröffentlichungsport, über den Sie auf die Anwendung zugreifen möchten und das Docker-Image, das Ihre Anwendung enthält. Wenn Ihr benutzerdefiniertes Image in einer Azure Container Registry-Instanz gespeichert ist, weisen Sie den Benutzer*innen der Anwendung die Rolle Mitwirkender zu. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Verwalten des Zugriffs auf einen Azure Machine Learning-Arbeitsbereich.
Fügen Sie optional Umgebungsvariablen hinzu, die Sie für Ihre Anwendung verwenden möchten.
Verwenden Sie Bindungsbereitstellungen, um den Zugriff auf die Dateien in Ihrem Standardspeicherkonto hinzuzufügen:
- Geben Sie /home/azureuser/cloudfiles für Hostpfad an.
- Geben Sie /home/azureuser/cloudfiles für Containerpfad an.
- Wählen Sie Hinzufügen aus, um diese Einbindung hinzuzufügen. Da die Dateien eingebunden sind, stehen Änderungen, die Sie daran vornehmen, auch in anderen Compute-Instanzen und Anwendungen zur Verfügung.
Wählen Sie Erstellen aus, um die benutzerdefinierte Anwendung auf Ihrer Compute-Instanz einzurichten.

Wichtig

Zugreifen auf benutzerdefinierte Anwendungen in Studio

Greifen Sie auf die benutzerdefinierten Anwendungen zu, die Sie in Studio eingerichtet haben:

Wählen Sie links Compute aus.
Ihre Anwendungen werden auf der Registerkarte Compute-Instanz in der Spalte Anwendungen angezeigt.

Screenshot: Zugriff auf das Studio für Ihre benutzerdefinierten Anwendungen

Hinweis

Nach dem Einrichten einer benutzerdefinierten Anwendung kann es ein paar Minuten dauern, bis Sie über die Links darauf zugreifen können. Der Zeitaufwand hängt von der Größe des für Ihre Anwendung verwendeten Images ab. Wenn Sie beim Zugriff auf die Anwendung eine 502-Fehlermeldung erhalten, warten Sie einige Zeit, bis die Anwendung eingerichtet ist und versuchen Sie es erneut. Wenn das benutzerdefinierte Image aus einer Azure Container Registry-Instanz abgerufen wird, benötigen Sie die Rolle Mitwirkender für den Arbeitsbereich. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Verwalten des Zugriffs auf einen Azure Machine Learning-Arbeitsbereich.

Freigeben über

Erstellen einer Compute-Instanz von Azure Machine Learning

Voraussetzungen

Erstellen

Konfigurieren des Herunterfahrens bei Leerlauf

Planen des automatischen Startens und Beendens

Erstellen eines Zeitplans

Erstellen eines Zeitplans mithilfe einer Resource Manager-Vorlage

Azure Policy-Unterstützung zur Vorgabe eines Zeitplans

Erstellen im Namen von

Zuweisen einer verwalteten Identität

Aktivieren des SSH-Zugriffs

Einrichten eines SSH-Schlüssels zu einem späteren Zeitpunkt

Verbinden mit SSH

Hinzufügen benutzerdefinierter Anwendungen wie RStudio oder Posit Workbench

Einrichten von Posit Workbench (früher RStudio Workbench)

Einrichten von RStudio (Open Source)

Einrichten weiterer benutzerdefinierter Anwendungen

Zugreifen auf benutzerdefinierte Anwendungen in Studio

Feedback

Zusätzliche Ressourcen

Freigeben über

Erstellen einer Compute-Instanz von Azure Machine Learning

Voraussetzungen

Erstellen

Konfigurieren des Herunterfahrens bei Leerlauf

Planen des automatischen Startens und Beendens

Erstellen eines Zeitplans

Erstellen eines Zeitplans mithilfe einer Resource Manager-Vorlage

Azure Policy-Unterstützung zur Vorgabe eines Zeitplans

Erstellen im Namen von

Zuweisen einer verwalteten Identität

Aktivieren des SSH-Zugriffs

Einrichten eines SSH-Schlüssels zu einem späteren Zeitpunkt

Verbinden mit SSH

Hinzufügen benutzerdefinierter Anwendungen wie RStudio oder Posit Workbench

Einrichten von Posit Workbench (früher RStudio Workbench)

Einrichten von RStudio (Open Source)

Einrichten weiterer benutzerdefinierter Anwendungen

Zugreifen auf benutzerdefinierte Anwendungen in Studio

Zugehöriger Inhalt

Feedback

Zusätzliche Ressourcen