Schnellstart: Bereitstellen einer Microsoft Foundry-Ressource mithilfe einer Bicep Datei

In dieser Schnellstartanleitung stellen Sie eine Microsoft FoundryRessource und ein Projekt mithilfe einer Vorlage Microsoft Bicep bereit. Bicep hilft Ihnen, verwandte Ressourcen in einer koordinierten Bereitstellung zu erstellen und dieselbe Konfiguration in allen Umgebungen wiederzuverwenden.

Wenn Sie bereits eine Foundry-Ressource im Azure-Portal konfiguriert haben, können Sie diese Konfiguration als Bicep Datei exportieren anstatt eine Vorlage von Grund auf neu zu erstellen.

Tipp

Für produktionsfähige Bicep-Vorlagen, die allgemeine Bereitstellungsszenarien von Foundry abdecken, siehe den Ordner "infrastructure-setup-bicep" im Repository "Foundry Samples". Klonen Sie das Repository, und passen Sie die Vorlagen an, anstatt von Grund auf neu zu beginnen.

Voraussetzungen

Ein Azure Konto mit einem aktiven Abonnement. Wenn Sie kein Konto haben, erstellen Sie ein free Azure Konto, das ein kostenloses Testabonnement enthält.

Abrufen der Beispieldateien:

git clone https://github.com/microsoft-foundry/foundry-samples
cd foundry-samples/infrastructure/infrastructure-setup-bicep/00-basic

Bicep-Datei bereitstellen

Stellen Sie die Bicep Datei mithilfe von Azure CLI oder Azure PowerShell bereit:

az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters aiFoundryName=myai aiProjectName=myai-proj

Referenz: az group create, az deployment group create.

Hinweis

Ersetzen Sie myai durch den Namen Ihrer Ressource. exampleRG ist der Name der Ressourcengruppe, und eastus ist die Azure Region, in der Ressourcen bereitgestellt werden.

Nach Abschluss der Bereitstellung wird eine Meldung angezeigt, die angibt, dass die Bereitstellung erfolgreich war (Ausgabe wird angezeigt: "provisioningState": "Succeeded"). Dadurch wird bestätigt, dass Ihre Foundry-Ressource und Ihr Projekt erstellt wurden.

Exportieren einer vorhandenen Ressource in eine Bicep Datei

Wenn Sie bereits eine Foundry-Ressource im Azure-Portal konfiguriert haben, können Sie diese Konfiguration als Bicep Datei exportieren. Die exportierte Datei erfasst Ihre aktuellen Ressourceneinstellungen, einschließlich Netzwerkregeln, Identitätskonfiguration und Projektzuordnungen. Verwenden Sie sie als Ausgangspunkt für wiederholbare Bereitstellungen in allen Umgebungen.

  1. Im Azure-Portal wechseln Sie zu Ihrer Foundry-Ressource.

  2. Erweitern Sie im linken Menü die Automatisierung, und wählen Sie dann " Vorlage exportieren" aus.

    Screenshot des linken Menüs einer Foundry-Ressource, bei dem die Gruppe „Automation“ erweitert und „Export template“ ausgewählt ist.

  3. Wählen Sie die Registerkarte Bicep aus, um den generierten Bicep Code anzuzeigen.

    Screenshot der Seite „Foundry-Export“ mit ausgewählter Registerkarte „Bicep“, auf der die Schaltflächen „Herunterladen“ und „Kopieren“ oberhalb des generierten Bicep-Codes angezeigt werden.

  4. Wählen Sie "Herunterladen " aus, um die Datei lokal zu speichern, oder "Kopieren ", um den Code in die Zwischenablage zu kopieren.

Hinweis

Der Export kann mit Warnungen abgeschlossen werden, wenn einige Ressourcentypen den vollständigen Export nicht unterstützen. Überprüfen Sie die Ausgabe, und füllen Sie alle fehlenden Eigenschaften manuell aus.

Anpassen der exportierten Vorlage

Die exportierte Bicep Datei enthält hartcodierte Werte, die für Ihr Abonnement und Ihre Ressourcengruppe spezifisch sind. Bevor Sie die Vorlage wiederverwenden, überprüfen und aktualisieren Sie Folgendes:

  • Ersetzen Sie hartcodierte Abonnement-IDs, Ressourcengruppennamen und Ressourcen-IDs durch Bicep Parameter.
  • Entfernen Sie alle Eigenschaften, die Sie nicht benötigen oder auf Ressourcen außerhalb des Bereitstellungsbereichs verweisen.
  • Fügen Sie Sicherheitskonfigurationen hinzu, oder passen Sie sie an die Anforderungen Ihrer Organisation an.

Informationen zu produktionsfähigen Bicep Vorlagen mit bereits integrierten Unternehmenssicherheitskonfigurationen finden Sie im Ordner "infrastructure-setup-bicep" im Repository "Foundry Samples".

Wenn Sie Ihre Vorlage anpassen, sollten Sie die folgenden Sicherheitskonfigurationen hinzufügen. Wählen Sie basierend auf Ihren Governanceanforderungen:

Steuerung Wann sie hinzugefügt werden soll Weitere Informationen
Private Endpunkte (Netzwerkisolation) Ihre Organisation verbietet öffentliche Endpunkte, oder Sie müssen den Datenverkehr in Ihrem virtuellen Netzwerk für die Compliance (HIPAA, PCI, FedRAMP) beibehalten. Konfigurieren der Netzwerkisolation mit privaten Endpunkten
Vom Kunden verwaltete Schlüssel (CMK) für die Verschlüsselung Sie müssen den Lebenszyklus der Verschlüsselungsschlüssel, das Rotationsintervall oder den Widerruf kontrollieren, oder Ihre Datenklassifizierung erfordert die Verwendung kundeneigener Schlüssel (Bring Your Own Key, BYOK). Einrichten von vom Kunden verwalteten Schlüsseln für die Verschlüsselung
Rollenbasierte Zugriffskontrolle (RBAC) Entweder benötigen Sie für Entwickler im Vergleich zu Administratoren Zugriff mit den geringstmöglichen Berechtigungen, oder Sie gewähren mehreren Teams, die sich eine Foundry-Ressource teilen, Zugriff. Konfigurieren der rollenbasierten Zugriffssteuerung für Foundry
Agent-Funktioneneinstellungen Ihre Agents müssen Zustands-, Vektordaten und Dateien in Azure Ressourcen speichern, die Sie besitzen, und nicht in plattformverwalteten Ressourcen. Konfigurieren von Agent-Funktioneneinstellungen
Custom-Azure Policy definitionen Ihr Plattformteam erzwingt einen Sicherheitsgrundwert (zulässige Regionen, erforderliche Tags, zulässige SKUs, obligatorische CMK oder private Verknüpfungen) für jede von der Organisation erstellte Foundry-Ressource. Definiert benutzerdefinierte Azure Policy definitionen

Überprüfen von Bereitstellungsberechtigungen vor der Bereitstellung

Wenn Ihre Vorlage Einstellungen für Agentfunktionen festlegt, benötigt die Identität, die die Bereitstellung ausführt, mehr als nur die Berechtigung zum Erstellen der Foundry-Ressource. Bestätigen Sie jeden der folgenden Punkte, bevor Sie die Bereitstellung durchführen, da eine fehlende Zuordnung dazu führt, dass die Bereitstellung mitten im Vorgang fehlschlägt:

  • Dem Bereitstellungsprinzipal ist für jedes Azure Storage-Konto, auf das die Vorlage verweist, die Rolle Storage Blob Data Contributor zugewiesen.
  • Der Bereitstellungsprinzipal verfügt für jedes Azure Cosmos DB-Konto, auf das die Vorlage verweist, über Cosmos DB Operator.

Azure KI-Suche erfordert keine Anruferrolle für die Bereitstellung von Funktionseinstellungen. Ihr Bereitstellungsprinzipal benötigt weiterhin die Berechtigungen, die zum Erstellen oder Aktualisieren jeder in der Vorlage deklarierten Ressource erforderlich sind.

Führen Sie den folgenden Befehl aus, um die aktuellen Zuordnungen des Bereitstellungsprinzipals aufzulisten:

az role assignment list --assignee <principal-id> --all --output table

Gewähren Sie nach der Bereitstellung Runtimezugriff

Bereitstellungsberechtigungen und Laufzeitberechtigungen sind getrennt. Nachdem die Bereitstellung erfolgreich abgeschlossen wurde, gewähren Sie der verwalteten Identität des Projekts die für jede referenzierte Ressource erforderlichen Rollen der Datenebene, und bestätigen Sie anschließend, dass ein Agent Lese- und Schreibzugriff hat. Die Aufruferrollen im vorherigen Abschnitt erfüllen diese Anforderung nicht. Die Rollenliste pro Ressource finden Sie unter Standard-Agent-Setup.

Überprüfen Sie die Bicep-Datei (optional)

Überprüfen Sie optional die Bicep Vorlage, um die Ressourcendefinitionen zu verstehen.

Die in diesem Artikel verwendete Bicep Datei finden Sie unter https://github.com/microsoft-foundry/foundry-samples/tree/main/infrastructure/infrastructure-setup-bicep/00-basic.

Diese Vorlage erstellt die folgenden Ressourcen:

Überprüfen der bereitgestellten Ressourcen

Verwenden Sie das Foundry-Portal , um die erstellten Ressourcen anzuzeigen. Sie können auch Azure CLI oder Azure PowerShell verwenden, um die Ressourcen auflisten zu können.

az resource list --resource-group exampleRG

Bereinigen von Ressourcen

Wenn Sie beabsichtigen, mit nachfolgenden Schnellstarts und Lernprogrammen fortzufahren, können Sie die ressourcen, die Sie in dieser Schnellstartanleitung erstellt haben, beibehalten. Wenn Sie die Ressourcen entfernen möchten, verwenden Sie den folgenden Befehl.

az group delete --name exampleRG

Referenz: az-Gruppe löschen

Problembehandlung

Symptom Ursache Resolution
ServiceModelDeprecating Fehler während der Bereitstellung Die Bicep-Vorlage enthält eine Modellbereitstellung, die auf eine außer Betrieb genommene oder veraltete Modellversion verweist. Öffnen Sie main.bicep, suchen Sie den Ressourcenblock modelDeployment und kommentieren Sie ihn entweder aus oder aktualisieren Sie das Modell name und version auf ein derzeit verfügbares Modell. Führen Sie diese Option az cognitiveservices model list --location <your-location> --query "[?model.lifecycleStatus=='GenerallyAvailable']" aus, um verfügbare Modelle zu finden.
The content for this response was already consumed Azure CLI Versionen 2.74–2.75 haben einen bekannten Fehler, der den tatsächlichen Bereitstellungsfehler maskiert. Führen Sie den Befehl erneut mit --debug aus und suchen Sie in der Ausgabe nach Exception Details:, um den tatsächlichen Fehler zu finden.
Die Bereitstellung schlägt mit AccountNameInvalid fehl Der aiFoundryName Wert muss global eindeutig, 2 bis 64 Zeichen sein und darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten. Wählen Sie einen anderen Namen, z. B. <your-name>-foundry-<random-suffix>.
Ressourcen werden in einer anderen Region als der Ressourcengruppe bereitgestellt. Der Parameter location der Bicep-Vorlage ist standardmäßig auf eastus2 festgelegt, die Ressourcengruppe befindet sich jedoch möglicherweise in einer anderen Region. Übergeben Sie den location Parameter explizit. Fügen Sie location=eastus zum Beispiel Ihrer --parameters-Liste hinzu.

Verwandte Inhalte

  • Zuletzt aktualisiert um