Azure Machine Learning-werkruimten tussen abonnementen verplaatsen (preview)

Artikel
10/16/2024

Naarmate de vereisten van uw Machine Learning-toepassing veranderen, moet u uw werkruimte mogelijk verplaatsen naar een ander Azure-abonnement. In de volgende situaties moet u de werkruimte bijvoorbeeld verplaatsen:

Niveau van werkruimte verhogen van testabonnement naar productieabonnement.
Het ontwerp en de architectuur van uw toepassing wijzigen.
Verplaats de werkruimte naar een abonnement met meer beschikbare quota.
Verplaats de werkruimte naar een abonnement met verschillende kostenplaats.

Als u de werkruimte verplaatst, kunt u de werkruimte en de inhoud ervan als één geautomatiseerde stap migreren. In de volgende tabel wordt de inhoud van de werkruimte beschreven die wordt verplaatst:

Werkruimte-inhoud	Verplaatst met werkruimte
Gegevensarchieven	Ja
Gegevenssets	Nee
Experimenttaken	Ja
Omgevingen	Ja
Modellen en andere assets die zijn opgeslagen in de werkruimte	Ja
Rekenresources	Nee
Eindpunten	Nee

Belangrijk

De verplaatsing van de werkruimte is momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt.
Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Vereisten

Een Azure Machine Learning-werkruimte in het bronabonnement. Zie Werkruimteresources maken voor meer informatie.
U moet machtigingen hebben voor het beheren van resources in zowel bron- als doelabonnementen. Bijvoorbeeld de rol Inzender of Eigenaar op abonnementsniveau. Zie Azure-rollen voor meer informatie over rollen.
- U hebt machtigingen nodig om resources te verwijderen van de bronlocatie.
- U hebt machtigingen nodig om resources te maken op de doellocatie.
- De verplaatsing mag geen inbreuk maken op Azure-beleid op de doellocatie.
- Roltoewijzingen voor het bereik van de bronwerkruimte worden niet verplaatst; u moet ze opnieuw maken in de bestemming.

Het doelabonnement moet zijn geregistreerd voor de vereiste resourceproviders. De volgende tabel bevat een lijst met de resourceproviders die vereist zijn voor Azure Machine Learning:

Resourceprovider	Waarom dit nodig is
Microsoft.MachineLearningServices	De Azure Machine Learning-werkruimte maken.
Microsoft.Storage	Azure Storage-account wordt gebruikt als de standaardopslag voor de werkruimte.
Microsoft.ContainerRegistry	Azure Container Registry wordt door de werkruimte gebruikt om Docker-installatiekopieën te bouwen.
Microsoft.KeyVault	Azure Key Vault wordt door de werkruimte gebruikt om geheimen op te slaan.
Microsoft.Notebooks/NotebookProxies	Geïntegreerde notebooks in een Azure Machine Learning-rekenproces.
Microsoft.ContainerService	Als u van plan bent getrainde modellen te implementeren in Azure Kubernetes Services.

Als u van plan bent om een door de klant beheerde sleutel te gebruiken met Azure Machine Learning, moeten de volgende serviceproviders zijn geregistreerd:

Resourceprovider	Waarom dit nodig is
Microsoft.DocumentDB/databaseAccounts	Azure Cosmos DB-exemplaar dat metagegevens voor de werkruimte registreert.
Microsoft.Search/searchServices	Azure Search biedt indexeringsmogelijkheden voor de werkruimte.

Zie Fouten oplossen voor de registratie van de resourceprovider voor informatie over het registreren van resourceproviders.

De Azure CLI.

Tip

De verplaatsingsbewerking maakt geen gebruik van de Azure CLI-extensie voor machine learning.

Ondersteunde scenario's

Geautomatiseerde werkruimte wordt verplaatst tussen resourcegroepen of abonnementen binnen dezelfde regio. Zie Resources verplaatsen naar een nieuwe resourcegroep of een nieuw abonnement voor meer informatie.

Notitie

De werkruimte moet stil zijn vóór de verplaatsing; berekeningen worden verwijderd, geen live-eindpunten of actieve experimenten.
Het verplaatsen van een werkruimte met geconfigureerde privé-eindpunten wordt ondersteund. De privé-eindpunten worden losgekoppeld en transitieve privé-eindpunten worden na de verplaatsing opnieuw gemaakt. U bent echter verantwoordelijk voor het goedkeuren van de nieuwe privé-eindpunten (inclusief het privé-eindpunt van de werkruimte) na de verplaatsing.

Beperkingen

Verplaatsen van werkruimten is niet bedoeld voor het repliceren van werkruimten of het verplaatsen van afzonderlijke assets, zoals modellen of gegevenssets van de ene werkruimte naar de andere.
Verplaatsing van werkruimten biedt geen ondersteuning voor migratie tussen Azure-regio's.
Verplaatsing van werkruimten biedt geen ondersteuning voor migratie tussen Microsoft Entra-tenants.

Tip

Zie het artikel Een Azure-abonnement overdragen naar een ander Microsoft Entra-id-artikel voor meer informatie over het handmatig verplaatsen van tenants.
De werkruimte mag niet worden gebruikt tijdens de verplaatsingsbewerking. Controleer of alle experimenttaken, gegevensprofileringstaken en labelprojecten zijn voltooid. Controleer ook of deductie-eindpunten niet worden aangeroepen.
De werkruimte is niet meer beschikbaar tijdens de verplaatsing.
Voordat u naar de verplaatsing gaat, moet u berekeningen en deductie-eindpunten uit de werkruimte verwijderen of loskoppelen.
Gegevensarchieven kunnen na de verplaatsing nog steeds de oude abonnementsgegevens weergeven. Zie Scenario: Een werkruimte verplaatsen met niet-standaardgegevensarchieven voor stappen voor het handmatig bijwerken van de gegevensarchieven.

De volgende scenario's worden niet ondersteund:

Werkruimte met berekeningen (bestaande berekeningen of tijdens het maken van de berekening).
Werkruimte met geïmplementeerde services.
Werkruimte met online-eindpunten/implementaties.
Werkruimte geconfigureerd voor door de klant beheerde sleutel.
Werkruimte met momenteel actieve labelprojecten.
Werkruimte gekoppeld aan Azure Databricks.
Werkruimte verplaatsen tussen regio's.

De verplaatsing voorbereiden en valideren

Stel in Azure CLI het abonnement in op het abonnement van uw oorspronkelijke werkruimte
```
az account set -s origin-sub-id
```
Controleer of de oorspronkelijke werkruimte niet wordt gebruikt. Controleer of alle experimenttaken, gegevensprofileringstaken of labelprojecten zijn voltooid. Controleer ook of deductie-eindpunten niet worden aangeroepen.
Verwijder of ontkoppel alle berekeningen uit de werkruimte en verwijder eventuele deductie-eindpunten. Het verplaatsen van berekeningen en eindpunten wordt niet ondersteund. Houd er ook rekening mee dat de werkruimte tijdens de verplaatsing niet meer beschikbaar is.
Maak een doelresourcegroep in het nieuwe abonnement. Deze resourcegroep bevat de werkruimte na de verplaatsing. De bestemming moet zich in dezelfde regio bevinden als de oorsprong.
```
az group create -g destination-rg -l my-region --subscription destination-sub-id                  
```
De volgende opdracht laat zien hoe u de verplaatsingsbewerking voor de werkruimte kunt valideren. U kunt gekoppelde resources, zoals opslagaccount, containerregister, sleutelkluis en Application Insights, toevoegen aan de verplaatsing door ze toe te voegen aan de resources lijst. De validatie kan enkele minuten duren. In deze opdracht origin-rg is de oorspronkelijke resourcegroep, terwijl destination-rg dit het doel is. De abonnements-id's zijn origin-sub-id endestination-sub-id, terwijl de werkruimte:origin-workspace-name
```
az resource invoke-action --action validateMoveResources --ids "/subscriptions/origin-sub-id/resourceGroups/origin-rg" --request-body "{  \"resources\": [\"/subscriptions/origin-sub-id/resourceGroups/origin-rg/providers/Microsoft.MachineLearningServices/workspaces/origin-workspace-name\"],\"targetResourceGroup\":\"/subscriptions/destination-sub-id/resourceGroups/destination-rg\" }"
```

De werkruimte verplaatsen

Nadat de validatie is voltooid, verplaatst u de werkruimte. U kunt ook eventuele gekoppelde resources toevoegen aan de verplaatsingsbewerking door ze toe te voegen aan de ids parameter. Deze bewerking kan enkele minuten duren.

az resource move --destination-group destination-rg --destination-subscription-id destination-sub-id --ids "/subscriptions/origin-sub-id/resourceGroups/origin-rg/providers/Microsoft.MachineLearningServices/workspaces/origin-workspace-name"

Nadat de verplaatsing is voltooid, maakt u alle berekeningen opnieuw en implementeert u alle webservice-eindpunten op de nieuwe locatie.

Scenario: Een werkruimte verplaatsen met niet-standaardgegevensarchieven

De geautomatiseerde verplaatsingsbewerking voor werkruimten verplaatst geen niet-standaardgegevensarchieven. Gebruik de volgende stappen om de referenties voor het gegevensarchief na de verplaatsing handmatig bij te werken.

Selecteer gegevens in Azure Machine Learning-studio en selecteer vervolgens een niet-standaardgegevensarchief. Controleer voor elk niet-standaardgegevensarchief of de velden Abonnements-id en Resourcegroepnaam leeg zijn. Als dat zo is, selecteert u Verificatie bijwerken.

Selecteer in het dialoogvenster Referenties voor het gegevensarchief bijwerken de abonnements-id en de naam van de resourcegroep waarnaar het opslagaccount is verplaatst en selecteer vervolgens Opslaan.
Als de velden Abonnements-id en Resourcegroepnaam zijn ingevuld voor de niet-standaardgegevensassets en verwijzen naar de abonnements-id en resourcegroep vóór de verplaatsing, voert u de volgende stappen uit:
1. Ga naar het tabblad Gegevensarchieven , selecteer het gegevensarchief en selecteer registratie ongedaan maken.
2. Selecteer Maken om het gegevensarchief te maken.
3. Gebruik in het dialoogvenster Gegevensarchief maken dezelfde naam, hetzelfde type, enzovoort als het gegevensarchief dat u niet hebt geregistreerd. Selecteer de abonnements-id en het opslagaccount op de nieuwe locatie. Selecteer ten slotte Maken om de nieuwe gegevensarchiefregistratie te maken.