Přidání a konfigurace katalogu z GitHubu nebo Azure Repos

Tento článek vysvětluje, jak přidat a nakonfigurovat katalog pro vývojové centrum nebo projekt prostředí nasazení Azure.

Katalogy vám pomůžou poskytnout sadu kurátorovaných šablon infrastruktury jako kódu (IaC), které se označují jako definice prostředí pro vývojové týmy pro vytváření prostředí. Jako katalog můžete připojit vlastní úložiště správy zdrojového kódu z GitHubu nebo Azure Repos a zadat složku s definicemi prostředí. Prostředí nasazení prohledávají složku s definicemi prostředí a zpřístupňuje je vývojových týmů k vytváření prostředí.

Pokud chcete šablony dále zabezpečit, katalog se zašifruje; Prostředí nasazení Azure podporuje šifrování neaktivních uložených dat pomocí šifrovacích klíčů spravovaných platformou, které spravuje Microsoft pro služby Azure.

• Informace o hostování úložiště na GitHubu najdete v tématu Začínáme s GitHubem.
• Informace o hostování úložiště Git v projektu Azure Repos najdete v tématu Azure Repos.

Microsoft nabízí katalog rychlých startů, který můžete přidat do vývojového centra nebo projektu, a ukázkový katalog, který můžete použít jako úložiště. Můžete také použít vlastní privátní úložiště nebo můžete vytvořit fork a přizpůsobit definice prostředí v ukázkovém katalogu.

V tomto článku získáte informace o těchto tématech:

1. Konfigurace katalogů na úrovni projektu
2. Konfigurace spravované identity
3. Přidání katalogu z Azure Repos nebo GitHubu
4. Aktualizace katalogu
5. Odstranění katalogu
6. Řešení chyb synchronizace katalogu

Konfigurace katalogů na úrovni projektu

Připojení katalogů na úrovni projektu umožňuje technikům platformy poskytovat kurátorované definice prostředí, které jsou specifické pro vývojové týmy. Kromě toho umožňuje potenciálním zákazníkům vývojářům přiřazeným jako správce projektu spravovat definice prostředí zpřístupněné jejich týmům.

Technici platformy mají plnou kontrolu nad používáním katalogů na úrovni projektu. Použití katalogů na úrovni projektu musí být povoleno na úrovni dev center, aby bylo možné katalog přidat do projektu. Inženýři platformy mohou také nakonfigurovat, které typy položek katalogu, jako jsou definice prostředí, je možné využívat na úrovni projektu.

Ve výchozím nastavení je použití katalogů na úrovni projektu zakázané a nejsou povoleny žádné typy položek katalogu. Definice prostředí z katalogu na úrovni projektu se synchronizují a dají se použít za dvou podmínek. Nejprve musíte povolit katalogy založené na projektu na odpovídající úrovni centra pro vývoj. Za druhé je nutné povolit použití definic prostředí pro projekt.

Přidání katalogu do projektu

Katalogy na úrovni projektu musíte povolit na úrovni dev center, abyste mohli přidat katalog do projektu. Měli byste také povolit použití definic prostředí na úrovni projektu.

Povolení použití katalogů na úrovni projektu na úrovni dev center:

1. Na webu Azure Portal přejděte do vývojového centra.

2. V nabídce vlevo v části Nastavení vyberte Konfigurace.

   

3. V podokně Katalogy na úrovni projektu vyberte Povolit katalogy na jeden projekt a pak vyberte Použít.

   

Povolení použití definic prostředí v projektu:

1. Na webu Azure Portal přejděte do svého projektu.

2. V nabídce vlevo v části Nastavení vyberte Katalogy.

   

3. Na stránce Katalogy vyberte oprávnění položky katalogu.

   

4. V podokně Nastavení položky katalogu vyberte definice prostředí nasazení Azure, abyste povolili použití definic prostředí na úrovni projektu.

   

Teď můžete do projektu přidat katalog.

Pro katalogy, které používají spravovanou identitu nebo token PAT (PAT) k ověřování, musíte přiřadit spravovanou identitu pro projekt. Pro katalogy, které používají pat, musíte pat uložit do trezoru klíčů a udělit spravované identitě přístup k tajnému klíči trezoru klíčů.

Konfigurace spravované identity

Než budete moct připojit katalog k vývojovému centru nebo projektu, musíte nakonfigurovat spravovanou identitu označovanou také jako identita spravované služby (MSI). Můžete připojit spravovanou identitu přiřazenou systémem (msi přiřazenou systémem) nebo spravovanou identitu přiřazenou uživatelem (MSI přiřazenou uživatelem). Potom přiřadíte spravované identitě role, které umožní vývojovému centru nebo projektu vytvářet typy prostředí ve vašem předplatném a číst projekt Azure Repos, který obsahuje úložiště katalogu.

Pokud vaše vývojové centrum nebo projekt nemá připojené MSI, postupujte podle kroků v části Konfigurace spravované identity a vytvořte jednu a přiřaďte role pro spravovanou identitu.

Další informace o spravovaných identitách najdete v tématu Co jsou spravované identity pro prostředky Azure?

Přidání katalogu

Katalog můžete přidat z úložiště Azure Repos nebo z úložiště GitHub. Můžete se rozhodnout ověřit přiřazením oprávnění msi nebo pomocí pat, který ukládáte do trezoru klíčů.

Vyberte kartu pro typ úložiště a ověřování, které chcete použít.

Úložiště Azure Repos s VYUŽITÍM MSI

Pokud chcete přidat katalog, proveďte následující úlohy:

• Přiřaďte oprávnění ve službě Azure Repos pro spravovanou identitu.
• Přidejte úložiště jako katalog.

Přiřazení oprávnění pro spravovanou identitu v Azure Repos

Spravované identitě musíte udělit oprávnění k úložišti v Azure Repos.

1. Přihlaste se ke své organizaci Azure DevOps.

   Poznámka:

   Vaše organizace Azure DevOps musí být ve stejném adresáři jako předplatné Azure, které obsahuje vaše vývojové centrum nebo projekt.

2. Vyberte Nastavení organizace.

   

3. Na stránce Přehled vyberte Uživatelé.

   

4. Na stránce Uživatelé vyberte Přidat uživatele.

   

5. Dokončete přidání nových uživatelů zadáním nebo výběrem následujících informací a pak vyberte Přidat:

   Jméno	Hodnota
   Uživatelé nebo instanční objekty	Zadejte název vývojového centra nebo projektu. Pokud používáte MSI přiřazenou systémem, zadejte název vývojového centra nebo projektu, nikoli ID objektu spravovaného účtu. Pokud používáte MSI přiřazenou uživatelem, použijte název spravovaného účtu.
   Úroveň přístupu	Vyberte Basic.
   Přidat do projektů	Vyberte projekt, který obsahuje vaše úložiště.
   Skupiny Azure DevOps	Vyberte čtenáře projektu.
   Odesílání e-mailových pozvánek (jenom uživatelům)	Zrušte zaškrtnutí políčka.

   

Přidání úložiště jako katalogu

Prostředí nasazení Azure podporuje připojení úložišť Azure Repos a úložišť GitHub. Sadu kurátorovaných šablon IaC můžete uložit do úložiště. Připojení úložiště k vývojovému centru nebo projektu jako katalogu poskytuje vývojovým týmům přístup k šablonám a umožňuje jim rychle vytvářet konzistentní prostředí.

Následující kroky umožňují připojit úložiště Azure Repos.

1. Na webu Azure Portal přejděte do vývojového centra nebo projektu.

2. V nabídce vlevo v části Konfigurace prostředí vyberte Katalogy a pak vyberte Přidat.

   

3. V části Přidat katalog zadejte následující informace a pak vyberte Přidat:

   Pole	Hodnota
   Název	Zadejte Název pro katalog.
   Umístění katalogu	Vyberte Azure DevOps.
   Typ ověřování	Vyberte spravovanou identitu.
   Organizace	Vyberte svou organizaci Azure DevOps.
   Projekt	V seznamu projektů vyberte projekt, který ukládá úložiště.
   Repo	V seznamu úložišť vyberte úložiště, které chcete přidat.
   Větev	Vyberte větev.
   Cesta ke složce	Dev Box načte seznam složek ve vaší větvi. Vyberte složku, do které se ukládají šablony IaC.

   

4. V katalogu pro vývojové centrum nebo projekt ověřte, že se zobrazí váš katalog. Pokud je připojení úspěšné, stav přečte synchronizaci úspěšně. První připojení k katalogu může trvat několik minut.

Úložiště Azure Repos s využitím PAT

Pokud chcete přidat katalog, proveďte následující úlohy:

• Získejte adresu URL klonování úložiště Azure Repos.
• Vytvoření tokenu PAT (Personal Access Token).
• Uložte pat jako tajný klíč trezoru klíčů ve službě Azure Key Vault.
• Přidejte úložiště jako katalog.

Získání adresy URL pro klonování úložiště Azure Repos

1. Přejděte na domovskou stránku kolekce týmů (například https://contoso-web-team.visualstudio.com) a vyberte projekt.

2. Získejte adresu URL klonování úložiště Git v Azure Repos.

3. Zkopírujte a uložte adresu URL.

Vytvoření osobního přístupového tokenu v Azure Repos

1. Přejděte na domovskou stránku kolekce týmů (například https://contoso-web-team.visualstudio.com) a vyberte projekt.

2. Vytvořte pat.

3. Zkopírujte a uložte vygenerovaný token, abyste ho mohli použít později.

Vytvoření trezoru klíčů

K uložení pat použitého k udělení přístupu k vašemu úložišti potřebujete službu Azure Key Vault. Trezory klíčů můžou řídit přístup pomocí zásad přístupu nebo řízení přístupu na základě role (RBAC). Pokud máte existující trezor klíčů, můžete ho použít, ale měli byste zkontrolovat, jestli k řízení přístupu používá zásady přístupu nebo přiřazení RBAC. Nápovědu ke konfiguraci zásad přístupu pro trezor klíčů najdete v tématu Přiřazení zásad přístupu ke službě Key Vault.

Pomocí následujících kroků vytvořte trezor klíčů RBAC:

1. Přihlaste se k portálu Azure.

2. Do vyhledávacího pole zadejte Key Vault.

3. V seznamu výsledků vyberte Key Vault.

4. Na stránce Služby Key Vault vyberte Vytvořit.

5. Na kartě Vytvořit trezor klíčů zadejte následující informace:

   Jméno	Hodnota
   Název	Zadejte název trezoru klíčů.
   Předplatné	Vyberte předplatné, ve kterém chcete trezor klíčů vytvořit.
   Skupina prostředků	Použijte existující skupinu prostředků nebo vyberte Vytvořit novou a zadejte název skupiny prostředků.
   Místo	Vyberte umístění nebo oblast, ve které chcete trezor klíčů vytvořit.

   U ostatních možností ponechte výchozí hodnoty.

6. Na kartě Zásady přístupu vyberte řízení přístupu na základě role Azure a pak vyberte Zkontrolovat a vytvořit.

7. Na kartě Revize a vytvoření vyberte Vytvořit.

Pokud zásady vaší organizace vyžadují, abyste si zachovali privátní službu Key Vault z internetu, můžete nastavit službu Key Vault tak, aby umožňovala důvěryhodné služby Microsoft obejít pravidlo brány firewall.

Informace o tom, jak povolit důvěryhodné služby Microsoft obejít bránu firewall, najdete v tématu Konfigurace nastavení sítě služby Azure Key Vault.

Uložení osobního přístupového tokenu do trezoru klíčů

1. Ve službě Key Vault v nabídce vlevo vyberte Tajné kódy.

2. Na stránce Tajné kódy vyberte Generovat/Importovat.

3. Na stránce Vytvořit tajný kód:

   • Do pole Název zadejte popisný název tajného kódu.
   • Do pole Hodnota tajného kódu vložte pat, který jste zkopírovali dříve.
   • Vyberte Vytvořit.

Získání identifikátoru tajného kódu

Získejte cestu k tajnému kódu, který jste vytvořili v trezoru klíčů.

1. Na webu Azure Portal přejděte do svého trezoru klíčů.

2. Na stránce trezoru klíčů v nabídce vlevo vyberte Tajné kódy.

3. Na stránce Tajné kódy vyberte tajný klíč, který jste vytvořili dříve.

4. Na stránce verze vyberte AKTUÁLNÍ VERZI.

5. Na aktuální stránce verze vyberte pro identifikátor tajného kódu kopii.

Přidání úložiště jako katalogu

1. Na webu Azure Portal přejděte do vývojového centra nebo projektu.

2. Ujistěte se, že identita připojená k vývojovému centru nebo projektu má přístup k tajnému kódu trezoru klíčů, ve kterém je uložený váš osobní přístupový token.

3. V nabídce vlevo v části Konfigurace prostředí vyberte Katalogy a pak vyberte Přidat.

4. V části Přidat katalog zadejte následující informace a pak vyberte Přidat:

   Pole	Hodnota
   Název	Zadejte Název pro katalog.
   Umístění katalogu	Vyberte Azure DevOps.
   Typ ověřování	Vyberte osobní přístupový token.
   Organizace	Vyberte organizaci, která je hostitelem úložiště katalogu.
   Projekt	Vyberte projekt, který ukládá úložiště katalogu.
   Obchodní cestující	Vyberte úložiště, ve kterém je katalog uložen.
   Cesta ke složce	Vyberte složku, ve které jsou vaše šablony IaC.
   Identifikátor tajného kódu	Zadejte identifikátor tajného kódu, který obsahuje váš PAT úložiště. Při kopírování identifikátoru tajného kódu obsahuje připojovací řetězec na konci identifikátor verze, například v tomto příkladu: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Odebrání identifikátoru verze zajišťuje, že prostředí nasazení načte nejnovější verzi tajného kódu z trezoru klíčů. Pokud platnost vašeho pat vyprší, je potřeba aktualizovat pouze trezor klíčů. Příklad identifikátoru tajného kódu: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. V katalogu ověřte, že se zobrazí váš katalog. Pokud je připojení úspěšné, stav je připojen.

DevCenter App v úložišti GitHub

Pokud chcete přidat katalog, proveďte následující úlohy:

1. Instalace a konfigurace aplikace Microsoft Dev Center
2. Přiřaďte oprávnění v GitHubu pro úložiště.
3. Přidejte úložiště jako katalog.

Instalace aplikace Microsoft Dev Center

1. Přihlaste se k portálu Azure.

2. Přejděte do vývojového centra nebo projektu.

3. V nabídce vlevo v části Konfigurace prostředí vyberte Katalogy a pak vyberte Přidat.

4. V podokně Přidat katalog zadejte nebo vyberte následující:

   Pole	Hodnota
   Název	Zadejte Název pro katalog.
   Zdroj katalogu	Vyberte GitHub.
   Typ ověřování	Vyberte aplikaci GitHub.

5. Pokud chcete nainstalovat aplikaci Microsoft Dev Center, vyberte konfigurovat úložiště.

   

6. Pokud se zobrazí výzva k ověření na GitHubu, ověřte se.

7. Na stránce Microsoft DevCenter vyberte Konfigurovat.

   

8. Vyberte organizaci GitHubu, která obsahuje úložiště, které chcete přidat jako katalog. Abyste mohli tuto aplikaci nainstalovat, musíte být vlastníkem organizace.

   

9. Na stránce Nainstalovat Microsoft DevCenter vyberte Pouze vybrat úložiště, vyberte úložiště, které chcete přidat jako katalog, a pak vyberte Nainstalovat.

   

   Můžete vybrat více úložišť, která chcete přidat jako katalogy. Každé úložiště musíte přidat jako samostatný katalog, jak je popsáno v části Přidat úložiště jako katalog.

10. Na webu Microsoft DevCenter by Microsoft by chtěl oprávnění: page, zkontrolujte požadovaná oprávnění a pak vyberte Autorizovat Microsoft Dev Center.

    

Přidání úložiště jako katalogu

1. Vraťte se na Azure Portal.

2. V části Přidat katalog zadejte následující informace a pak vyberte Přidat:

   Pole	Hodnota
   Repo	Vyberte úložiště, které chcete přidat jako katalog.
   Větev	Vyberte větev.
   Cesta ke složce	Vyberte složku obsahující podsložky, které obsahují definice prostředí.

   

3. V katalogu ověřte, že se zobrazí váš katalog. Pokud je připojení úspěšné, stav přečte synchronizaci úspěšně.

   

Úložiště GitHub s PAT

Pokud chcete přidat katalog, proveďte následující úlohy:

• Získejte adresu URL klonování úložiště GitHub.
• Vytvořte osobní přístupový token (PAT) na GitHubu.
• Uložte pat jako tajný klíč trezoru klíčů ve službě Azure Key Vault.
• Přidejte úložiště jako katalog.

Získání adresy URL klonování úložiště GitHub

1. Přejděte na domovskou stránku úložiště GitHub, která obsahuje definice šablony.

2. Získejte adresu URL klonování úložiště GitHub.

3. Zkopírujte a uložte adresu URL.

Vytvoření osobního přístupového tokenu na GitHubu

Prostředí nasazení Azure podporuje ověřování v úložištích GitHubu pomocí klasických tokenů nebo jemně odstupňovaných tokenů. V tomto příkladu vytvoříte jemně odstupňovaný token.

1. Přejděte na domovskou stránku úložiště GitHub, která obsahuje definice šablony.

2. V pravém horním rohu GitHubu vyberte profilový obrázek a pak vyberte Nastavení.

3. Na levém bočním panelu vyberte Osobní přístupové tokeny>Nastavení>pro vývojáře s jemně odstupňovanými tokeny.

4. Vyberte Vygenerovat nový token.

5. Na stránce Nový jemně odstupňovaný osobní přístupový token zadejte následující informace:

   Jméno	Hodnota
   Název tokenu	Zadejte popisný název tokenu.
   Vypršení platnosti	Vyberte dobu vypršení platnosti tokenu ve dnech.
   Popis	Zadejte popis tokenu.
   Vlastník prostředku	Vyberte vlastníka úložiště.
   Přístup k úložišti	Vyberte Pouze úložiště.
   Výběr úložišť	Vyberte úložiště, které obsahuje definice prostředí.
   Oprávnění úložiště	V accessovém seznamu rozbalte oprávnění úložiště a v části Obsah vyberte Čtení kódu.

   

6. Vyberte Vygenerovat token.

7. Zkopírujte a uložte vygenerovaný token, abyste ho mohli použít později.

Důležité

Při práci s privátním úložištěm uloženým v organizaci GitHubu musíte zajistit, aby pat GitHubu byl nakonfigurovaný tak, aby poskytoval přístup ke správné organizaci a úložištím v ní.

• Klasické tokeny v rámci organizace musí být po vytvoření autorizované jednotným přihlašováním ke konkrétní organizaci.
• Jemně odstupňované tokeny musí mít vlastníka tokenu nastaveného jako vlastní organizaci, která má být autorizována.

Nesprávně nakonfigurované paty můžou vést k chybě nenalezené úložiště.

Vytvoření trezoru klíčů

K uložení tokenu PAT, který se používá k udělení přístupu k vašemu úložišti, potřebujete službu Azure Key Vault. Trezory klíčů můžou řídit přístup pomocí zásad přístupu nebo řízení přístupu na základě role (RBAC). Pokud máte existující trezor klíčů, můžete ho použít, ale měli byste zkontrolovat, jestli k řízení přístupu používá zásady přístupu nebo přiřazení RBAC. Nápovědu ke konfiguraci zásad přístupu pro trezor klíčů najdete v tématu Přiřazení zásad přístupu trezoru klíčů.

Pomocí následujících kroků vytvořte trezor klíčů RBAC:

1. Přihlaste se k portálu Azure.

2. Do vyhledávacího pole zadejte trezor klíčů.

3. V seznamu výsledků vyberte Key Vault.

4. Na stránce Služby Key Vault vyberte Vytvořit.

5. Na kartě Vytvořit trezor klíčů zadejte následující informace:

   Jméno	Hodnota
   Název	Zadejte název trezoru klíčů.
   Předplatné	Vyberte předplatné, ve kterém chcete trezor klíčů vytvořit.
   Skupina prostředků	Použijte existující skupinu prostředků nebo vyberte Vytvořit novou a zadejte název skupiny prostředků.
   Místo	Vyberte umístění nebo oblast, ve které chcete trezor klíčů vytvořit.

   U ostatních možností ponechte výchozí hodnoty.

6. Na kartě Zásady přístupu vyberte řízení přístupu na základě role Azure a pak vyberte Zkontrolovat a vytvořit.

7. Na kartě Revize a vytvoření vyberte Vytvořit.

Pokud zásady vaší organizace vyžadují, abyste si zachovali privátní službu Key Vault z internetu, můžete nastavit službu Key Vault tak, aby umožňovala důvěryhodné služby Microsoft obejít pravidlo brány firewall.

Informace o tom, jak povolit důvěryhodné služby Microsoft obejít bránu firewall, najdete v tématu Konfigurace nastavení sítě služby Azure Key Vault.

Uložení osobního přístupového tokenu do trezoru klíčů

1. Ve službě Key Vault v nabídce vlevo vyberte Tajné kódy.

2. Na stránce Tajné kódy vyberte Generovat/Importovat.

3. Na stránce Vytvořit tajný kód:

   • Do pole Název zadejte popisný název tajného kódu.
   • Do pole Tajné hodnoty vložte pat.
   • Vyberte Vytvořit.

Získání identifikátoru tajného kódu

Získejte cestu k tajnému kódu, který jste vytvořili v trezoru klíčů.

1. Na webu Azure Portal přejděte do svého trezoru klíčů.

2. Na stránce trezoru klíčů v nabídce vlevo vyberte Tajné kódy.

3. Na stránce Tajné kódy vyberte tajný klíč, který jste vytvořili dříve.

4. Na stránce verze vyberte AKTUÁLNÍ VERZI.

5. Na aktuální stránce verze vyberte pro identifikátor tajného kódu kopii.

Přidání úložiště jako katalogu

1. Na webu Azure Portal přejděte do vývojového centra nebo projektu.

2. Ujistěte se, že spravovaná identita připojená k vývojovému centru nebo projektu má přístup k tajnému kódu trezoru klíčů, ve kterém je uložený váš osobní přístupový token.

3. V nabídce vlevo v části Konfigurace prostředí vyberte Katalogy a pak vyberte Přidat.

4. V části Přidat katalog zadejte následující informace a pak vyberte Přidat.

   Pole	Hodnota
   Název	Zadejte Název pro katalog.
   Umístění katalogu	Vyberte GitHub.
   Repo	Zadejte nebo vložte adresu URL klonu pro úložiště GitHub nebo úložiště Azure Repos. Příklad ukázkového katalogu: https://github.com/Azure/deployment-environments.git
   Větev	Zadejte větev úložiště, ke které se chcete připojit. Příklad ukázkového katalogu: main
   Cesta ke složce	Zadejte cestu ke složce vzhledem k identifikátoru URI klonu, který obsahuje podsložky, které obsahují definice prostředí. Cesta ke složce je určená pro složku s podsložkami obsahujícími soubory prostředí definice prostředí, nikoli pro složku se samotným souborem prostředí definice prostředí. Následující obrázek ukazuje strukturu složek ukázkového katalogu. Příklad ukázkového katalogu: /Environments Cesta ke složce může začínat lomítkem nebo bez lomítka (/).
   Identifikátor tajného kódu	Zadejte identifikátor tajného kódu, který obsahuje váš PAT úložiště. Při kopírování identifikátoru tajného kódu obsahuje připojovací řetězec na konci identifikátor verze, například v tomto příkladu: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Odebrání identifikátoru verze zajišťuje, aby prostředí nasazení načítá nejnovější verzi tajného kódu z trezoru klíčů. Pokud platnost vašeho pat vyprší, je potřeba aktualizovat pouze trezor klíčů. Příklad identifikátoru tajného kódu: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. V katalogu ověřte, že se zobrazí váš katalog. Pokud je připojení úspěšné, stav přečte synchronizaci úspěšně.

Zobrazení synchronizovaných položek katalogu

Bez ohledu na typ používaného úložiště můžete zobrazit položky katalogu, které jsou synchronizované z katalogu.

1. V nabídce vlevo pro vývojové centrum nebo projekt v části Konfigurace prostředí vyberte Katalogy.

2. V podokně Katalogy vyberte název katalogu.

   

3. Zobrazí se seznam úspěšně synchronizovaných položek katalogu.

   

Aktualizace katalogu

Pokud aktualizujete definici nebo obsah šablony v připojeném úložišti, můžete vývojovému týmu poskytnout nejnovější sadu definic prostředí synchronizací katalogu. Katalog můžete synchronizovat ručně nebo automaticky.

Ruční synchronizace katalogu

Když ručně synchronizujete katalog, prostředí nasazení prohledá prostřednictvím úložiště a zpřístupní nejnovější seznam definic prostředí všem přidruženým projektům v vývojovém centru.

1. V nabídce vlevo pro vývojové centrum v části Konfigurace prostředí vyberte Katalogy.

2. Vyberte konkrétní katalog a pak na panelu příkazů vyberte Synchronizovat.

   

Automatická synchronizace katalogu

Když nakonfigurujete katalog tak, aby se synchronizoval automaticky, prostředí nasazení prověří úložiště každých 30 minut a zpřístupní nejnovější seznam definic prostředí všem přidruženým projektům v vývojovém centru.

1. V nabídce vlevo pro vývojové centrum nebo projekt v části Konfigurace prostředí vyberte Katalogy.

2. Vyberte konkrétní katalog a pak vyberte Upravit.

   

3. V podokně Upravit katalog vyberte Automaticky synchronizovat tento katalog a pak vyberte Uložit.

   

Pokud se automatická synchronizace nezdaří, měli byste provést ruční synchronizaci. Prostředí nasazení neprovádí žádné další pokusy o automatickou synchronizaci, dokud nebude ruční synchronizace úspěšná.

Odstranění katalogu

Katalog můžete odstranit a odebrat ho z vývojového centra nebo projektu prostředí nasazení Azure. Šablony v odstraněné katalogu nejsou při nasazování nových prostředí dostupné vývojovým týmům. Aktualizujte odkaz na definici prostředí pro všechna existující prostředí vytvořená pomocí definic prostředí v odstraněného katalogu. Pokud se odkaz neaktualizuje a prostředí se znovu nasadí, nasazení se nezdaří.

Odstranění katalogu:

1. V nabídce vlevo pro vývojové centrum nebo projekt v části Konfigurace prostředí vyberte Katalogy.

2. Vyberte konkrétní katalog a pak vyberte Odstranit.

3. V dialogovém okně Odstranit katalog vyberte Pokračovat , chcete-li katalog odstranit.

Řešení chyb synchronizace katalogu

Když přidáte nebo synchronizujete katalog, může dojít k chybě nebo upozornění synchronizace. Chyba synchronizace značí, že se nepodařilo úspěšně synchronizovat katalog, upozornění synchronizace indikuje, že některé nebo všechny položky katalogu obsahují chyby. Stav synchronizace a chyby můžete zobrazit na webu Azure Portal nebo můžete k řešení chyb použít Rozhraní příkazového řádku Azure a rozhraní REST API.

Zobrazení stavu synchronizace katalogu

Na webu Azure Portal můžete získat další informace o stavu synchronizace katalogu a případných upozorněních nebo chybách výběrem odkazu na stav. Odkaz na stav otevře podokno se stavem synchronizace, počtem přidaných definic prostředí a počtem ignorovaných nebo neúspěšných definic prostředí.

Zobrazení selhání synchronizace katalogu

1. V nabídce vlevo pro vývojové centrum nebo projekt v části Konfigurace prostředí vyberte Katalogy.

2. Ve sloupci Stav vyberte odkaz na stav katalogu, který se nepodařilo synchronizovat.

   

3. Zobrazí se podokno podrobností, které zobrazuje změny v poslední synchronizaci, počet chyb synchronizace a typ chyb.

   

Zobrazení upozornění synchronizace katalogu

1. V nabídce vlevo pro vývojové centrum nebo projekt v části Konfigurace prostředí vyberte Katalogy.

2. Ve sloupci Stav vyberte odkaz na stav katalogu, který se synchronizoval, ale hlásí upozornění.

   

3. Zobrazí se podokno podrobností, které zobrazuje změny v poslední synchronizaci, počet chyb položek a typ a zdroj jednotlivých chyb.

   

4. Položky, které se úspěšně synchronizovaly, můžete zobrazit z katalogu, který také hlásí chyby synchronizace. V podokně Katalogy vyberte název katalogu.

   

5. Zobrazí se seznam úspěšně synchronizovaných položek katalogu.

   

Řešení chyb synchronizace katalogu pomocí Azure CLI

K získání katalogu použijte Rozhraní příkazového řádku Azure nebo rozhraní REST API. V odpovědi GET se zobrazí typ chyby:

• Ignorované definice prostředí, které byly zjištěny jako duplicitní.
• Neplatné definice prostředí, které selhaly kvůli chybám schématu, odkazu nebo ověření

Řešení chyb s ignorovánou definicí prostředí

Pokud přidáte dvě nebo více definic prostředí se stejným názvem, dojde k chybě definice ignorované prostředí. Tento problém můžete vyřešit přejmenováním definic prostředí tak, aby každá definice prostředí má jedinečný název v katalogu.

Řešení chyb s neplatnou definicí prostředí

K chybě definice neplatného prostředí může dojít z různých důvodů:

• Chyby schématu manifestu Ujistěte se, že soubor prostředí definice prostředí odpovídá požadovanému schématu.

• Chyby ověření. Při řešení chyb ověřování zkontrolujte následující položky:

  • Ujistěte se, že je typ modulu souboru prostředí správně nakonfigurovaný.
  • Ujistěte se, že název definice prostředí má 3 až 63 znaků.
  • Ujistěte se, že název definice prostředí obsahuje pouze znaky platné pro adresu URL, což jsou alfanumerické znaky a tyto symboly: ~ ! , . ' ; : = - _ + ( ) * & $ @

• Referenční chyby Ujistěte se, že cesta šablony, na kterou odkazuje soubor prostředí, je platná relativní cesta k souboru v úložišti.

Související obsah

• Konfigurace typů prostředí pro vývojové centrum
• Vytvoření a konfigurace projektu pomocí Azure CLI
• Konfigurace typů prostředí projektu