Rychlý start: Připojení Azure Container Apps k databázím a službám pomocí konektoru service (Preview)

Začínáme s konektorem Service Connector pro připojení azure Container Apps k databázím, účtům úložiště a dalším službám Azure Service Connector zjednodušuje ověřování a konfiguraci a umožňuje připojení k prostředkům pomocí spravovaných identit nebo jiných metod ověřování.

Tento článek obsahuje podrobné pokyny pro Azure Portal i Azure CLI. Zvolte upřednostňovanou metodu pomocí karet výše.

Důležité

Podpora pro Service Connector (Preview) v Azure Container Apps končí 30. března 2026. Po tomto datu nejsou nová připojení služeb pomocí konektoru Service Connector (Preview) dostupná prostřednictvím žádného rozhraní. Další informace najdete v tématu UKONČENÍ: Service Connector (Preview) v Azure Container Apps.

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Aplikace nasazená v kontejnerových aplikacích v oblasti podporované konektorem služby Service Connector.
• Cílový prostředek pro připojení kontejnerových aplikací, jako je například účet Blob Storage.
• Potřebná oprávnění k vytváření a správě připojení služeb.

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Aplikace nasazená v kontejnerových aplikacích v oblasti podporované konektorem služby Service Connector.
• Cílový prostředek pro připojení kontejnerových aplikací, jako je například účet Blob Storage.
• Potřebná oprávnění k vytváření a správě připojení služeb.

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

• Tento rychlý start vyžaduje verzi 2.30.0 nebo vyšší azure CLI. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgradepříkaz . Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

Nastavení prostředí

1. Pokud konektor Service Connector používáte poprvé, spusťte příkaz az provider register a zaregistrujte poskytovatele prostředků konektoru služby.

   az provider register -n Microsoft.ServiceLinker
   

   Návod

   Spuštěním příkazu az provider show -n "Microsoft.ServiceLinker" --query registrationStatemůžete zkontrolovat, jestli už je poskytovatel prostředků zaregistrovaný. Pokud je Registeredvýstup , konektor Service Connector už je zaregistrovaný.

2. Volitelně spusťte příkaz az containerapp connection list-support-types a získejte seznam podporovaných cílových služeb pro Container Apps.

   az containerapp connection list-support-types --output table
   

Vytvoření připojení služby (Preview)

Pomocí konektoru service můžete vytvořit připojení služby mezi službami Azure Container Apps a Azure Blob Storage. Tento příklad ukazuje připojení ke službě Blob Storage, ale stejný proces můžete použít i pro další podporované služby Azure.

1. Vyberte vyhledávací panel Prohledat prostředky, služby a dokumenty (G +/) v horní části portálu Azure, do filtru zadejte Kontejnerové aplikace a vyberte Kontejnerové aplikace.

   

2. Vyberte název prostředku Container Apps, který chcete připojit k cílovému prostředku.

3. V levém obsahu vyberte Konektor služby (Preview ). Pak vyberte Vytvořit.

   

4. Na kartě Základy vyberte nebo zadejte následující nastavení.

   Nastavení	Příklad	Popis
   Kontejner	my-container-app	Kontejner v aplikaci kontejneru.
   Typ služby	Storage – objekt blob	Typ služby, kterou chcete připojit k aplikaci kontejneru.
   Předplatné	moje předplatné	Předplatné obsahující službu, ke které se chcete připojit. Výchozí hodnota je předplatné, které obsahuje tuto aplikaci kontejneru.
   Název připojení	storageblob_700ae	Název připojení, který identifikuje propojení mezi vaší aplikací kontejneru a cílovou službou. Použijte název připojení poskytovaný konektorem service connector nebo zvolte vlastní název připojení.
   Účet úložiště	my-storage-account	Cílový účet úložiště, ke kterému se chcete připojit. Pokud zvolíte jiný typ služby, vyberte odpovídající cílovou instanci služby.
   Typ klienta	.NET	Zásobník aplikací, který funguje s cílovou službou, kterou jste vybrali. Výchozí hodnota je None, která generuje seznam konfigurací. Pokud víte, že je vybraný zásobník aplikací nebo klientská sada SDK, vyberte pro typ klienta stejný zásobník aplikací.

5. Vyberte Next: Authentication pro výběr metody ověřování: systémem přiřazenou spravovanou identitu (SMI), uživatelem přiřazenou spravovanou identitu (UMI), připojovací řetězec nebo servisní principál.

   Spravovaná identita přiřazená systémem (doporučeno)

   Vyberte systémem přiřazenou spravovanou identitu pro připojení prostřednictvím identity, která je automaticky generována v Microsoft Entra ID a je svázána s životním cyklem instance služby. Toto je doporučená možnost ověřování.

   Spravovaná identita přiřazená uživatelem

   Vyberte uživatelsky přiřazenou spravovanou identitu k ověření prostřednictvím samostatné identity přidělené jedné nebo více instancím služby Azure. Vyberte předplatné, které obsahuje spravovanou identitu přiřazenou uživatelem, a pak vyberte identitu.

   Pokud ještě nemáte spravovanou identitu přiřazenou uživatelem, vytvořte ji:

   1. Otevřete platformu Azure na nové kartě a vyhledejte termín „Managed identities“.
   2. Vyberte Spravované identity a vyberte Vytvořit.
   3. Zadejte předplatné, skupinu prostředků, oblast a název instance.
   4. Vyberte Zkontrolovat a vytvořit a pak vytvořit.
   5. Po nasazení spravované identity se vraťte na kartu Konektor služby, vyberte Předchozí a potom Další , abyste aktualizovali data formuláře. V části Spravovaná identita přiřazená uživatelem vyberte identitu, kterou jste vytvořili.

   Další informace najdete v tématu Vytvoření spravované identity přiřazené uživatelem.

   Principál služby

   1. Výběrem instančního objektu použijte instanční objekt , který definuje zásady přístupu a oprávnění pro uživatele nebo aplikaci v MICROSOFT Entra ID.
   2. V seznamu vyberte service principal a zadejte tajný kód

   Připojovací řetězec

   Varování

   Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Ověřovací tok popsaný v tomto postupu vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích. Tento tok byste měli použít jenom v případě, že jiné bezpečnější toky, jako jsou spravované identity, nejsou přijatelné.

   Vyberte Připojovací řetězec a vygenerujte nebo nakonfigurujte jeden nebo více párů klíč-hodnota s čistými tajnými kódy nebo tokeny.

6. Vyberte Další: Sítě pro výběr konfigurace sítě a výběr možnosti Konfigurovat pravidla brány firewall pro povolení přístupu k cílové službě , aby vaše aplikace kontejneru mohla přistupovat ke službě Blob Storage.

   

7. Vyberte Další: Zkontrolujte a vytvořte a zkontrolujte zadané informace. Spuštění konečného ověření trvá několik sekund.

   

8. Výběrem možnosti Vytvořit vytvořte připojení služby. Dokončení operace může trvat až minutu.

Spravovaná identita (doporučeno)

Spuštěním az containerapp connection create příkazu vytvořte připojení služby z Container Apps ke službě Blob Storage se spravovanou identitou přiřazenou systémem. Tento příkaz můžete spustit dvěma různými způsoby:

• Krok za krokem vygenerujte nové připojení.

  az containerapp connection create storage-blob --system-identity
  

• Vygenerujte nové připojení najednou. Zástupné symboly nahraďte vlastními informacemi: <source-subscription>, <source_resource_group>, <app>, <target-subscription>, <target_resource_group>a <account>.

  az containerapp connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --system-identity
  

Návod

Pokud účet Blob Storage nemáte, spusťte az containerapp connection create storage-blob --new --system-identity ho, abyste ho vytvořili a připojili ho k aplikaci kontejneru pomocí spravované identity.

Připojovací řetězec

Varování

Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Ověřovací tok popsaný v tomto postupu vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích. Tento tok byste měli použít jenom v případě, že jiné bezpečnější toky, jako jsou spravované identity, nejsou přijatelné.

Spuštěním az containerapp connection create příkazu vytvořte připojení služby z Container Apps ke službě Blob Storage s připojovacím řetězcem. Tento příkaz můžete spustit dvěma různými způsoby:

• Krok za krokem vygenerujte nové připojení.

  az containerapp connection create storage-blob --secret
  

• Vygenerujte nové připojení najednou. Zástupné symboly nahraďte vlastními informacemi: <source-subscription>, <source_resource_group>, <app>, <target-subscription><target_resource_group>, , <account>, <secret-name>, a <secret>.

  az containerapp connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --secret name=<secret-name> secret=<secret>
  

Návod

Pokud účet Blob Storage nemáte, spusťte az containerapp connection create storage-blob --new --secret ho, abyste ho vytvořili a připojili ho k aplikaci kontejneru pomocí spravované identity.

Zobrazit připojení služeb

1. Připojení Container Apps se zobrazují v části Nastavení > Konektor služby (náhled). Výběrem > rozbalíte seznam a zobrazíte vlastnosti požadované vaší aplikací.

2. Vyberte připojení a poté ověřte pro vyzvání konektoru služby k ověření vašeho připojení.

3. Vyberte Další informace a zkontrolujte podrobnosti o ověření připojení.

   

Spuštěním příkazu az containerapp connection list zobrazte seznam všech zřízených připojení vaší aplikace kontejneru. Zástupné symboly <container-app-resource-group> a <container-app-name> z následujícího příkazu nahraďte vlastními informacemi. Můžete také odebrat --output table možnost zobrazení dalších informací o připojeních.

az containerapp connection list --resource-group "<container-app-resource-group>" --name "<container-app-name>" --output table

Výstup také zobrazí stav zřizování připojení.

Související obsah

Další informace o konektoru služby najdete v následujících příručkách:

• Interní informace o konektoru služby
• Kontejnerové aplikace: Připojení aplikace Java Quarkus k PostgreSQL
• Kontejnerové aplikace: Připojení aplikace ASP.NET Core ke konfiguraci aplikací