Een catalogus toevoegen en configureren vanuit GitHub of Azure-opslagplaatsen

In dit artikel wordt uitgelegd hoe u een catalogus toevoegt en configureert voor uw azure Deployment Environments-ontwikkelaarscentrum of -project.

Catalogi helpen u een set gecureerde IaC-sjablonen (infrastructure-as-code) te bieden, ook wel omgevingsdefinities genoemd voor uw ontwikkelteams om omgevingen te maken. U kunt uw eigen opslagplaats voor broncodebeheer toevoegen vanuit GitHub of Azure DevOps als catalogus en de map opgeven met uw omgevingsdefinities. Implementatieomgevingen scannen de map op omgevingsdefinities en maken ze beschikbaar voor ontwikkelteams om omgevingen te maken.

Om uw sjablonen verder te beveiligen, wordt de catalogus versleuteld; Azure Deployment Environments ondersteunt versleuteling-at-rest met door het platform beheerde versleutelingssleutels, die door Microsoft voor Azure Services worden beheerd.

• Zie Aan de slag met GitHub voor meer informatie over het hosten van een opslagplaats in GitHub.
• Zie Azure-opslagplaatsen voor meer informatie over het hosten van een Git-opslagplaats in een Azure-opslagplaatsproject.

Microsoft biedt een snelstartcatalogus die u kunt toevoegen aan het ontwikkelaarscentrum of project en een voorbeeldcatalogus die u als opslagplaats kunt gebruiken. U kunt ook uw eigen privéopslagplaats gebruiken of u kunt de omgevingsdefinities in de voorbeeldcatalogus splitsen en aanpassen.

In dit artikel leert u het volgende:

1. Catalogi op projectniveau configureren
2. Een beheerde identiteit configureren
3. Een catalogus toevoegen vanuit Azure-opslagplaatsen of GitHub
4. Een catalogus bijwerken
5. Een catalogus verwijderen
6. Catalogussynchronisatiefouten oplossen

Catalogi op projectniveau configureren

Als u catalogi op projectniveau koppelt, kunnen platformtechnici gecureerde omgevingsdefinities bieden die specifiek zijn voor de ontwikkelteams. Daarnaast biedt het ontwikkelaarsteam leads die zijn toegewezen als Project-Beheer s om de omgevingsdefinities te beheren die beschikbaar zijn gemaakt voor hun teams.

Platformtechnici hebben volledige controle over het gebruik van catalogi op projectniveau. Het gebruik van catalogussen op projectniveau moet zijn ingeschakeld op het niveau van het ontwikkelaarscentrum voordat een catalogus kan worden toegevoegd aan een project. Platformtechnici kunnen ook configureren welke typen catalogusitems, zoals omgevingsdefinities, op projectniveau kunnen worden gebruikt.

Het gebruik van catalogi op projectniveau is standaard uitgeschakeld en geen van de catalogusitemstypen is ingeschakeld. Omgevingsdefinities van een catalogus op projectniveau worden gesynchroniseerd en alleen bruikbaar wanneer beide projectcatalogussen worden geactiveerd op het bijbehorende niveau van het ontwikkelaarscentrum en omgevingsdefinities zijn ingeschakeld voor het project.

Een beheerde identiteit configureren

Voordat u een catalogus kunt koppelen aan een ontwikkelaarscentrum of project, moet u een beheerde identiteit configureren, ook wel een Managed Service Identity (MSI) genoemd. U kunt een door het systeem toegewezen beheerde identiteit koppelen (door het systeem toegewezen MSI) of een door de gebruiker toegewezen beheerde identiteit (door de gebruiker toegewezen MSI). Vervolgens wijst u rollen toe aan de beheerde identiteit, zodat het ontwikkelaarscentrum of project omgevingstypen in uw abonnement kan maken en het Azure-opslagplaatsproject met de catalogusopslagplaats kan lezen.

Als aan uw ontwikkelaarscentrum of project geen MSI is gekoppeld, volgt u de stappen in Een beheerde identiteit configureren om er een te maken en rollen toe te wijzen voor de beheerde identiteit.

Zie Wat zijn beheerde identiteiten voor Azure-resources voor meer informatie over beheerde identiteiten?

Een catalogus toevoegen

U kunt een catalogus toevoegen vanuit een Opslagplaats voor Azure-opslagplaatsen of een GitHub-opslagplaats. U kunt ervoor kiezen om te verifiëren door machtigingen toe te wijzen aan een MSI of door een PAT te gebruiken, die u in een sleutelkluis opslaat.

Selecteer het tabblad voor het type opslagplaats en verificatie dat u wilt gebruiken.

Opslagplaats van Azure-opslagplaatsen met MSI

Voer de volgende taken uit om een catalogus toe te voegen:

• Wijs machtigingen toe in Azure-opslagplaatsen voor de beheerde identiteit.
• Voeg uw opslagplaats toe als catalogus.

Machtigingen toewijzen in Azure-opslagplaatsen voor de beheerde identiteit

U moet de beheerde identiteit machtigen voor de opslagplaats in Azure-opslagplaatsen.

1. Meld u aan bij uw Azure DevOps-organisatie.

   Notitie

   Uw Azure DevOps-organisatie moet zich in dezelfde map bevinden als het Azure-abonnement dat uw ontwikkelaarscentrum of project bevat.

2. Selecteer Organisatie-instellingen.

   

3. Selecteer Gebruikers op de pagina Overzicht.

   

4. Selecteer Gebruikers toevoegen op de pagina Gebruikers.

   

5. Voltooi Nieuwe gebruikers toevoegen door de volgende gegevens in te voeren of te selecteren en selecteer vervolgens Toevoegen:

   Naam	Weergegeven als
   Gebruikers of service-principals	Voer de naam in van uw ontwikkelaarscentrum of project. Wanneer u een door het systeem toegewezen MSI gebruikt, geeft u de naam van het ontwikkelaarscentrum of project op, niet de object-id van het beheerde account. Wanneer u een door de gebruiker toegewezen MSI gebruikt, gebruikt u de naam van het beheerde account.
   Toegangsniveau	Selecteer Basic.
   Toevoegen aan projecten	Selecteer het project dat uw opslagplaats bevat.
   Azure DevOps-groepen	Selecteer Projectlezers.
   Uitnodigingen voor e-mail verzenden (alleen voor gebruikers)	Schakel het selectievakje uit.

   

Uw opslagplaats toevoegen als catalogus

Azure Deployment Environments biedt ondersteuning voor het koppelen van Azure-opslagplaatsen en GitHub-opslagplaatsen. U kunt een set gecureerde IaC-sjablonen opslaan in een opslagplaats. Als u de opslagplaats als catalogus aan een ontwikkelaarscentrum of project koppelt, hebben uw ontwikkelteams toegang tot de sjablonen en kunnen ze snel consistente omgevingen maken.

Met de volgende stappen kunt u een Opslagplaats voor Azure-opslagplaatsen koppelen.

1. Navigeer in Azure Portal naar uw ontwikkelaarscentrum of project.

2. Selecteer Catalogs in het linkermenu onder Omgevingsconfiguratie en selecteer vervolgens Toevoegen.

   

3. Voer in Catalogus toevoegen de volgende gegevens in en selecteer vervolgens Toevoegen:

   Veld	Weergegeven als
   Naam	Voer een naam in voor de catalogus.
   Cataloguslocatie	Selecteer Azure DevOps.
   Verificatietype	Selecteer Beheerde identiteit.
   Organisatie	Selecteer uw Azure DevOps-organisatie.
   Project	Selecteer in de lijst met projecten het project waarin de opslagplaats wordt opgeslagen.
   Repo	Selecteer in de lijst met opslagplaatsen de opslagplaats die u wilt toevoegen.
   Vertakking	Selecteer de vertakking.
   Mappad	Dev Box haalt een lijst met mappen in uw vertakking op. Selecteer de map waarin uw IaC-sjablonen worden opgeslagen.

   

4. Controleer in Catalogs voor het ontwikkelaarscentrum of project of uw catalogus wordt weergegeven. Wanneer de verbinding tot stand is gebracht, wordt de status gesynchroniseerd. Verbinding maken naar een catalogus kan de eerste keer enkele minuten duren.

Opslagplaats van Azure-opslagplaatsen met PAT

Voer de volgende taken uit om een catalogus toe te voegen:

• Haal de kloon-URL op voor uw Opslagplaats voor Azure-opslagplaatsen.
• Maak een persoonlijk toegangstoken (PAT).
• Sla de PAT op als een sleutelkluisgeheim in Azure Key Vault.
• Voeg uw opslagplaats toe als catalogus.

De kloon-URL voor uw Opslagplaats voor Azure-opslagplaatsen ophalen

1. Ga naar de startpagina van uw teamverzameling (bijvoorbeeld https://contoso-web-team.visualstudio.com) en selecteer vervolgens uw project.

2. Haal de kloon-URL van uw Git-opslagplaats voor Azure-opslagplaatsen op.

3. Kopieer en sla de URL op.

Een persoonlijk toegangstoken maken in Azure-opslagplaatsen

1. Ga naar de startpagina van uw teamverzameling (bijvoorbeeld https://contoso-web-team.visualstudio.com) en selecteer uw project.

2. Maak een PAT.

3. Kopieer en sla het gegenereerde token op dat later moet worden gebruikt.

Een sleutelkluis maken

U hebt een Azure Key Vault nodig om de PAT op te slaan die wordt gebruikt om Azure toegang te verlenen tot uw opslagplaats. Sleutelkluizen kunnen de toegang beheren met toegangsbeleid of op rollen gebaseerd toegangsbeheer (RBAC). Als u een bestaande sleutelkluis hebt, kunt u deze gebruiken, maar moet u controleren of er toegangsbeleid of RBAC-toewijzingen worden gebruikt om de toegang te beheren. Zie Toegangsbeleid voor Key Vault toewijzen voor hulp bij het configureren van een toegangsbeleid voor een sleutelkluis.

Gebruik de volgende stappen om een RBAC-sleutelkluis te maken:

1. Meld u aan bij het Azure-portaal.

2. Typ Sleutelkluis in het zoekvak.

3. Selecteer Key Vault in de lijst met resultaten.

4. Selecteer Maken op de pagina Key Vault.

5. Geef op het tabblad Sleutelkluis maken de volgende informatie op:

   Naam	Weergegeven als
   Naam	Voer een naam in voor de sleutelkluis.
   Abonnement	Selecteer het abonnement waarin u de sleutelkluis wilt maken.
   Resourcegroep	Gebruik een bestaande resourcegroep of selecteer Nieuwe maken en voer een naam in voor de resourcegroep.
   Location	Selecteer de locatie of regio waar u de sleutelkluis wilt maken.

   Laat de overige opties op de standaardwaarden staan.

6. Selecteer op het tabblad Toegangsbeleid op basis van rollen toegangsbeheer van Azure en selecteer vervolgens Beoordelen en maken.

7. Selecteer op het tabblad Beoordelen en maken de optie Maken.

Als het beleid van uw organisatie vereist dat u uw Key Vault privé van internet houdt, kunt u uw Key Vault zo instellen dat vertrouwde Microsoft-services uw firewallregel overslaan.

Zie Azure Key Vault-netwerkinstellingen configureren voor meer informatie over het toestaan van vertrouwde Microsoft-services om de firewall te omzeilen.

Het persoonlijke toegangstoken opslaan in de sleutelkluis

1. Selecteer Geheimen in het menu aan de linkerkant in key vault.

2. Selecteer Genereren/importeren op de pagina Geheimen.

3. Op de pagina Een geheim maken:

   • Voer in het vak Naam een beschrijvende naam in voor uw geheim.
   • Plak in het vak Geheime waarde de PAT die u eerder hebt gekopieerd.
   • Selecteer Maken.

De geheime id ophalen

Haal het pad op naar het geheim dat u in de sleutelkluis hebt gemaakt.

1. Ga in de Azure-portal naar uw sleutelkluis.

2. Selecteer Geheimen in het linkermenu op de pagina van de sleutelkluis.

3. Selecteer op de pagina Geheimen het geheim dat u eerder hebt gemaakt.

4. Selecteer op de pagina Versies de HUIDIGE VERSIE.

5. Selecteer kopie op de huidige versiepagina voor de geheime id.

Uw opslagplaats toevoegen als catalogus

1. Ga in Azure Portal naar uw ontwikkelaarscentrum of project.

2. Zorg ervoor dat de identiteit die is gekoppeld aan het ontwikkelaarscentrum of project toegang heeft tot het sleutelkluisgeheim waar uw persoonlijke toegangstoken is opgeslagen.

3. Selecteer Catalogs in het linkermenu onder Omgevingsconfiguratie en selecteer vervolgens Toevoegen.

4. Voer in Catalogus toevoegen de volgende gegevens in en selecteer vervolgens Toevoegen:

   Veld	Weergegeven als
   Naam	Voer een naam in voor de catalogus.
   Cataloguslocatie	Selecteer Azure DevOps.
   Verificatietype	Selecteer persoonlijk toegangstoken.
   Organisatie	Selecteer de organisatie die als host fungeert voor de catalogusopslagplaats.
   Project	Selecteer het project waarin de catalogusopslagplaats wordt opgeslagen.
   Rep	Selecteer de opslagplaats waarin de catalogus wordt opgeslagen.
   Mappad	Selecteer de map met uw IaC-sjablonen.
   Geheime id	Voer de geheime id in die uw PAT voor de opslagplaats bevat. Wanneer u een geheime id kopieert, bevat de verbindingsreeks een versie-id aan het einde, zoals in dit voorbeeld: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Als u de versie-id verwijdert, zorgt u ervoor dat implementatieomgevingen de nieuwste versie van het geheim uit de sleutelkluis ophalen. Als uw PAT verloopt, moet alleen de sleutelkluis worden bijgewerkt. Voorbeeld van geheime id:https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Controleer in Catalogi of uw catalogus wordt weergegeven. Als de verbinding is geslaagd, wordt de status Verbinding maken.

DevCenter-app voor GitHub-opslagplaats

Voer de volgende taken uit om een catalogus toe te voegen:

1. De Microsoft Ontwikkelaarscentrum-app installeren en configureren
2. Wijs machtigingen toe in GitHub voor de opslagplaatsen.
3. Voeg uw opslagplaats toe als catalogus.

Microsoft Ontwikkelaarscentrum-app installeren

1. Meld u aan bij het Azure-portaal.

2. Navigeer naar uw ontwikkelaarscentrum of project.

3. Selecteer Catalogs in het linkermenu onder Omgevingsconfiguratie en selecteer vervolgens Toevoegen.

4. Voer in het deelvenster Catalogus toevoegen het volgende in of selecteer het volgende:

   Veld	Weergegeven als
   Naam	Voer een naam in voor de catalogus.
   Catalogusbron	Selecteer GitHub.
   Verificatietype	Selecteer de GitHub-app.

5. Als u de Microsoft Ontwikkelaarscentrum-app wilt installeren, selecteert u Uw opslagplaatsen configureren.

   

6. Als u wordt gevraagd om te verifiëren bij GitHub, moet u zich verifiëren.

7. Selecteer Configureren op de pagina Microsoft DevCenter.

   

8. Selecteer de GitHub-organisatie die de opslagplaats bevat die u als catalogus wilt toevoegen. U moet eigenaar van de organisatie zijn om deze app te installeren.

   

9. Selecteer op de pagina Microsoft DevCenter installeren alleen opslagplaatsen, selecteer de opslagplaats die u als catalogus wilt toevoegen en selecteer Vervolgens Installeren.

   

   U kunt meerdere opslagplaatsen selecteren die u als catalogus wilt toevoegen. U moet elke opslagplaats toevoegen als een afzonderlijke catalogus, zoals beschreven in Uw opslagplaats toevoegen als catalogus.

10. Controleer op het Microsoft DevCenter van Microsoft toestemming voor: pagina, controleer de vereiste machtigingen en selecteer vervolgens Microsoft Ontwikkelaarscentrum autoriseren.

    

Uw opslagplaats toevoegen als catalogus

1. Ga terug naar de Azure-portal.

2. Voer in Catalogus toevoegen de volgende gegevens in en selecteer vervolgens Toevoegen:

   Veld	Waarde
   Repo	Selecteer de opslagplaats die u als catalogus wilt toevoegen.
   Vertakking	Selecteer de vertakking.
   Mappad	Selecteer de map met submappen die uw omgevingsdefinities bevatten.

   

3. Controleer in Catalogi of uw catalogus wordt weergegeven. Wanneer de verbinding tot stand is gebracht, wordt de status gesynchroniseerd.

   

GitHub-opslagplaats met PAT

Voer de volgende taken uit om een catalogus toe te voegen:

• Haal de kloon-URL van uw GitHub-opslagplaats op.
• Maak een persoonlijk toegangstoken (PAT) in GitHub.
• Sla de PAT op als een sleutelkluisgeheim in Azure Key Vault.
• Voeg uw opslagplaats toe als catalogus.

De kloon-URL van uw GitHub-opslagplaats ophalen

1. Ga naar de startpagina van de GitHub-opslagplaats die de sjabloondefinities bevat.

2. Haal de kloon-URL van de GitHub-opslagplaats op.

3. Kopieer en sla de URL op.

Een persoonlijk toegangstoken maken in GitHub

Azure Deployment Environments ondersteunt verificatie bij GitHub-opslagplaatsen met behulp van klassieke tokens of fijnmazige tokens. In dit voorbeeld maakt u een fijnmazig token.

1. Ga naar de startpagina van de GitHub-opslagplaats die de sjabloondefinities bevat.

2. Selecteer in de rechterbovenhoek van GitHub de profielafbeelding en selecteer vervolgens Instellingen.

3. Selecteer in de zijbalk aan de linkerkant persoonlijke toegangstokens> voor ontwikkelaarsinstellingen.>

4. Selecteer Nieuw token genereren.

5. Geef op de pagina Nieuw gedetailleerd persoonlijk toegangstoken de volgende informatie op:

   Naam	Weergegeven als
   Tokennaam	Voer een beschrijvende naam in voor het token.
   Vervaldatum	Selecteer de verloopperiode van het token in dagen.
   Beschrijving	Voer een beschrijving in voor het token.
   Resource-eigenaar	Selecteer de eigenaar van de opslagplaats.
   Toegang tot opslagplaats	Selecteer Alleen opslagplaatsen selecteren.
   Opslagplaatsen selecteren	Selecteer de opslagplaats die de omgevingsdefinities bevat.
   Opslagplaatsmachtigingen	Vouw opslagplaatsmachtigingen uit en selecteer code-lezen in de lijst Access voor inhoud.

   

6. Selecteer Het token genereren.

7. Kopieer en sla het gegenereerde token op dat later moet worden gebruikt.

Belangrijk

Wanneer u werkt met een privéopslagplaats die is opgeslagen in een GitHub-organisatie, moet u ervoor zorgen dat de GitHub PAT is geconfigureerd om toegang te verlenen tot de juiste organisatie en de opslagplaatsen erin.

• Klassieke tokens binnen de organisatie moeten zijn gemachtigd voor eenmalige aanmelding voor de specifieke organisatie nadat ze zijn gemaakt.
• Fijnmazige tokens moeten de eigenaar van het token hebben ingesteld als de organisatie zelf die moet worden geautoriseerd.

Onjuist geconfigureerde PAW's kunnen ertoe leiden dat er geen fout is gevonden in de opslagplaats.

Een sleutelkluis maken

U hebt een Azure Key Vault nodig om de PAT op te slaan die wordt gebruikt om Azure toegang te verlenen tot uw opslagplaats. Sleutelkluizen kunnen de toegang beheren met toegangsbeleid of op rollen gebaseerd toegangsbeheer (RBAC). Als u een bestaande sleutelkluis hebt, kunt u deze gebruiken, maar moet u controleren of er toegangsbeleid of RBAC-toewijzingen worden gebruikt om de toegang te beheren. Zie Een toegangsbeleid voor een sleutelkluis toewijzen voor hulp bij het configureren van een toegangsbeleid voor een sleutelkluis.

Gebruik de volgende stappen om een RBAC-sleutelkluis te maken:

1. Meld u aan bij het Azure-portaal.

2. Voer in het zoekvak de sleutelkluis in.

3. Selecteer Key Vault in de lijst met resultaten.

4. Selecteer Maken op de pagina Key Vault.

5. Geef op het tabblad Sleutelkluis maken de volgende informatie op:

   Naam	Weergegeven als
   Naam	Voer een naam in voor de sleutelkluis.
   Abonnement	Selecteer het abonnement waarin u de sleutelkluis wilt maken.
   Resourcegroep	Gebruik een bestaande resourcegroep of selecteer Nieuwe maken en voer een naam in voor de resourcegroep.
   Location	Selecteer de locatie of regio waar u de sleutelkluis wilt maken.

   Laat de overige opties op de standaardwaarden staan.

6. Selecteer op het tabblad Toegangsbeleid op basis van rollen toegangsbeheer van Azure en selecteer vervolgens Beoordelen en maken.

7. Selecteer op het tabblad Beoordelen en maken de optie Maken.

Als het beleid van uw organisatie vereist dat u uw Key Vault privé van internet houdt, kunt u uw Key Vault zo instellen dat vertrouwde Microsoft-services uw firewallregel overslaan.

Zie Azure Key Vault-netwerkinstellingen configureren voor meer informatie over het toestaan van vertrouwde Microsoft-services om de firewall te omzeilen.

Het persoonlijke toegangstoken opslaan in de sleutelkluis

1. Selecteer Geheimen in het menu aan de linkerkant in key vault.

2. Selecteer Genereren/importeren op de pagina Geheimen.

3. Op de pagina Een geheim maken:

   • Voer in het vak Naam een beschrijvende naam in voor uw geheim.
   • Plak uw PAT in het vak Geheime waarde .
   • Selecteer Maken.

De geheime id ophalen

Haal het pad op naar het geheim dat u in de sleutelkluis hebt gemaakt.

1. Ga in de Azure-portal naar uw sleutelkluis.

2. Selecteer Geheimen in het linkermenu op de pagina van de sleutelkluis.

3. Selecteer op de pagina Geheimen het geheim dat u eerder hebt gemaakt.

4. Selecteer op de pagina Versies de HUIDIGE VERSIE.

5. Selecteer kopie op de huidige versiepagina voor de geheime id.

Uw opslagplaats toevoegen als catalogus

1. Ga in Azure Portal naar uw ontwikkelaarscentrum of project.

2. Zorg ervoor dat de beheerde identiteit die is gekoppeld aan het ontwikkelaarscentrum of project toegang heeft tot het sleutelkluisgeheim waar uw persoonlijke toegangstoken is opgeslagen.

3. Selecteer Catalogs in het linkermenu onder Omgevingsconfiguratie en selecteer vervolgens Toevoegen.

4. Voer in Catalogus toevoegen de volgende gegevens in en selecteer Vervolgens Toevoegen.

   Veld	Weergegeven als
   Naam	Voer een naam in voor de catalogus.
   Cataloguslocatie	Selecteer GitHub.
   Repo	Voer de kloon-URL in of plak deze voor uw GitHub-opslagplaats of uw Azure-opslagplaats. Voorbeeldcatalogusvoorbeeld:https://github.com/Azure/deployment-environments.git
   Vertakking	Voer de opslagplaatsbranch in waarmee u verbinding wilt maken. Voorbeeldcatalogusvoorbeeld:main
   Mappad	Voer het mappad in ten opzichte van de kloon-URI die submappen bevat die uw omgevingsdefinities bevatten. Het mappad is voor de map met submappen met omgevingsdefinitieomgevingsbestanden, niet voor de map met het omgevingsdefinitieomgevingsbestand zelf. In de volgende afbeelding ziet u de mapstructuur van de voorbeeldcatalogus. Voorbeeldcatalogusvoorbeeld:/Environments Het pad naar de map kan beginnen met of zonder een slash (/).
   Geheime id	Voer de geheime id in die uw PAT voor de opslagplaats bevat. Wanneer u een geheime id kopieert, bevat de verbindingsreeks een versie-id aan het einde, zoals in dit voorbeeld: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Als u de versie-id verwijdert, zorgt u ervoor dat implementatieomgevingen de meest recente versie van het geheim ophalen uit de sleutelkluis. Als uw PAT verloopt, moet alleen de sleutelkluis worden bijgewerkt. Voorbeeld van geheime id:https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Controleer in Catalogi of uw catalogus wordt weergegeven. Wanneer de verbinding tot stand is gebracht, wordt de status gesynchroniseerd.

Gesynchroniseerde catalogusitems weergeven

Ongeacht het type opslagplaats dat u gebruikt, kunt u de catalogusitems bekijken die vanuit de catalogus zijn gesynchroniseerd.

1. Selecteer Catalogs in het linkermenu voor uw ontwikkelaarscentrum of project, onder Omgevingsconfiguratie.

2. Selecteer in het deelvenster Catalogi de naam van de catalogus.

   

3. U ziet een lijst met gesynchroniseerde catalogusitems.

   

Een catalogus bijwerken

Als u de definitie of sjablooninhoud in de bijgevoegde opslagplaats bijwerkt, kunt u de meest recente set omgevingsdefinities opgeven voor uw ontwikkelteams door de catalogus te synchroniseren. U kunt een catalogus handmatig of automatisch synchroniseren.

Een catalogus handmatig synchroniseren

Wanneer u een catalogus handmatig synchroniseert, scant Implementatieomgevingen via de opslagplaats en maakt de meest recente lijst met omgevingsdefinities beschikbaar voor alle gekoppelde projecten in het ontwikkelaarscentrum.

1. Selecteer Catalogs in het linkermenu voor uw ontwikkelaarscentrum, onder Omgevingsconfiguratie.

2. Selecteer de specifieke catalogus en selecteer vervolgens in de opdrachtbalk De optie Synchroniseren.

   

Een catalogus automatisch synchroniseren

Wanneer u een catalogus configureert om automatisch te synchroniseren, scant Implementatieomgevingen elke 30 minuten de opslagplaats en maakt de meest recente lijst met omgevingsdefinities beschikbaar voor alle gekoppelde projecten in het ontwikkelaarscentrum.

1. Selecteer Catalogs in het linkermenu voor uw ontwikkelaarscentrum of project, onder Omgevingsconfiguratie.

2. Selecteer de specifieke catalogus en selecteer vervolgens Bewerken.

   

3. Selecteer deze catalogus automatisch synchroniseren in het deelvenster Catalogus bewerken en selecteer Opslaan.

   

Een catalogus verwijderen

U kunt een catalogus verwijderen om deze te verwijderen uit het ontwikkelaarscentrum of project van Azure Deployment Environments. Sjablonen in een verwijderde catalogus zijn niet beschikbaar voor ontwikkelteams wanneer ze nieuwe omgevingen implementeren. Werk de referentie voor de omgevingsdefinitie bij voor bestaande omgevingen die zijn gemaakt met behulp van de omgevingsdefinities in de verwijderde catalogus. Als de verwijzing niet wordt bijgewerkt en de omgeving opnieuw wordt geïmplementeerd, mislukt de implementatie.

Een catalogus verwijderen:

1. Selecteer Catalogs in het linkermenu voor uw ontwikkelaarscentrum of project, onder Omgevingsconfiguratie.

2. Selecteer de specifieke catalogus en selecteer vervolgens Verwijderen.

3. Selecteer In het dialoogvenster Catalogus verwijderen de optie Doorgaan om de catalogus te verwijderen.

Catalogussynchronisatiefouten oplossen

Wanneer u een catalogus toevoegt of synchroniseert, kan er een synchronisatiefout of waarschuwing optreden. Een synchronisatiefout geeft aan dat een catalogus niet kan worden gesynchroniseerd. Een synchronisatiewaarschuwing geeft aan dat sommige of alle catalogusitems fouten hebben. U kunt de synchronisatiestatus en -fouten bekijken in Azure Portal of de Azure CLI en REST API gebruiken om de fouten op te lossen.

Synchronisatiestatus van catalogus weergeven

In Azure Portal krijgt u meer informatie over de synchronisatiestatus van de catalogus en eventuele waarschuwingen of fouten door de statuskoppeling te selecteren. Met de statuskoppeling wordt een deelvenster geopend met de synchronisatiestatus, het aantal omgevingsdefinities dat is toegevoegd en het aantal omgevingsdefinities dat is genegeerd of mislukt.

Catalogussynchronisatiefouten weergeven

1. Selecteer Catalogs in het linkermenu voor uw ontwikkelaarscentrum of project, onder Omgevingsconfiguratie.

2. Selecteer in de kolom Status de statuskoppeling voor de catalogus die niet kan worden gesynchroniseerd.

   

3. U ziet een detailvenster met de wijzigingen in de laatste synchronisatie, het aantal synchronisatiefouten en het type fouten.

   

Synchronisatiewaarschuwingen voor catalogus weergeven

1. Selecteer Catalogs in het linkermenu voor uw ontwikkelaarscentrum of project, onder Omgevingsconfiguratie.

2. Selecteer in de kolom Status de statuskoppeling voor de catalogus die is gesynchroniseerd, maar rapporteert een waarschuwing.

   

3. U ziet een detailvenster met de wijzigingen in de laatste synchronisatie, het aantal itemfouten en het type en de bron van elke fout.

   

4. U kunt items weergeven die zijn gesynchroniseerd vanuit een catalogus die ook synchronisatiefouten rapporteert. Selecteer in het deelvenster Catalogi de naam van de catalogus.

   

5. U ziet een lijst met gesynchroniseerde catalogusitems.

   

Problemen met catalogussynchronisatie oplossen met behulp van de Azure CLI

Gebruik de Azure CLI of de REST API om de catalogus op te halen . In het GET-antwoord ziet u het type fout:

• Genegeerde omgevingsdefinities die zijn gedetecteerd als duplicaten.
• Ongeldige omgevingsdefinities die zijn mislukt vanwege schema-, verwijzings- of validatiefouten.

Genegeerde omgevingsdefinitiefouten oplossen

Er treedt een genegeerde omgevingsdefinitiefout op als u twee of meer omgevingsdefinities met dezelfde naam toevoegt. U kunt dit probleem oplossen door de naam van omgevingsdefinities te wijzigen, zodat elke omgevingsdefinitie een unieke naam in de catalogus heeft.

Ongeldige omgevingsdefinitiefouten oplossen

Er kan om verschillende redenen een ongeldige omgevingsdefinitiefout optreden:

• Manifestschemafouten. Zorg ervoor dat uw omgevingsdefinitiebestand overeenkomt met het vereiste schema.

• Validatiefouten. Controleer de volgende items om validatiefouten op te lossen:

  • Zorg ervoor dat het enginetype van het omgevingsbestand juist is geconfigureerd.
  • Zorg ervoor dat de naam van de omgevingsdefinitie tussen 3 en 63 tekens ligt.
  • Zorg ervoor dat de naam van de omgevingsdefinitie alleen tekens bevat die geldig zijn voor een URL. Dit zijn alfanumerieke tekens en deze symbolen: ~!,.';:=-_+()*&$@

• Verwijzingsfouten. Zorg ervoor dat het sjabloonpad waarnaar het omgevingsbestand verwijst een geldig relatief pad naar een bestand in de opslagplaats is.

Gerelateerde inhoud

• Omgevingstypen configureren voor een ontwikkelaarscentrum
• Een project maken en configureren met behulp van de Azure CLI
• Projectomgevingstypen configureren