Freigeben über

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

In dieser Schnellstartanleitung stellen Sie eine Microsoft Foundry-Ressource und ein Projekt mithilfe einer Microsoft Bicep-Vorlage 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 produktionsreife Bicep-Vorlagen, die allgemeine Bereitstellungsszenarien von Foundry abdecken, sehen Sie den Ordner "infrastructure-setup-bicep" im Foundry-Samples-Repository. 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/Azure-AI-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 Ressourcengruppe. 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 project 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. Wechseln Sie im Azure portal zu Ihrer Foundry-Ressource.
  2. Wählen Sie im linken Menü unter "Automatisierung" die Option "Vorlage exportieren" aus.
  3. Wählen Sie die Registerkarte "Bicep " aus, um den generierten Bicep-Code anzuzeigen.
  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.

Für produktionsfähige Bicep-Vorlagen mit bereits integrierten Unternehmenssicherheitskonfigurationen finden Sie im Repository "Foundry Samples" den Ordner "infrastructure-setup-bicep ".

Wenn Sie Ihre Vorlage anpassen, sollten Sie die folgenden Sicherheitskonfigurationen hinzufügen:

Überprüfen der 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/azure-ai-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 group delete

Verwandte Inhalte

  • Last updated on