Lägga till och konfigurera en katalog från GitHub eller Azure Repos

Den här artikeln beskriver hur du lägger till och konfigurerar en katalog för ditt Utvecklingscenter eller projekt för Azure Deployment Environments.

Kataloger hjälper dig att tillhandahålla en uppsättning utvalda IaC-mallar (infrastruktur som kod), så kallade miljödefinitioner för dina utvecklingsteam för att skapa miljöer. Du kan bifoga din egen källkontrolllagringsplats från GitHub eller Azure DevOps som en katalog och ange mappen med dina miljödefinitioner. Distributionsmiljöer söker igenom mappen efter miljödefinitioner och gör dem tillgängliga för utvecklingsteam för att skapa miljöer.

För att ytterligare skydda dina mallar krypteras katalogen. Azure Deployment Environments stöder kryptering i vila med plattformshanterade krypteringsnycklar som Hanteras av Microsoft för Azure Services.

• Information om hur du är värd för en lagringsplats i GitHub finns i Kom igång med GitHub.
• Mer information om hur du är värd för en Git-lagringsplats i ett Azure Repos-projekt finns i Azure Repos.

Microsoft erbjuder en snabbstartskatalog som du kan lägga till i utvecklingscentret eller projektet och en exempelkatalog som du kan använda som lagringsplats. Du kan också använda din egen privata lagringsplats, eller så kan du förgrena och anpassa miljödefinitionerna i exempelkatalogen.

I den här artikeln kan du se hur du:

1. Konfigurera kataloger på projektnivå
2. Konfigurera en hanterad identitet
3. Lägga till en katalog från Azure Repos eller GitHub
4. Uppdatera en katalog
5. Ta bort en katalog
6. Felsöka katalogsynkroniseringsfel

Konfigurera kataloger på projektnivå

Genom att koppla kataloger på projektnivå kan plattformstekniker tillhandahålla utvalda miljödefinitioner som är specifika för utvecklingsteamen. Dessutom kan utvecklingsteamets leads tilldelas som projektadministratörer för att hantera de miljödefinitioner som görs tillgängliga för deras team.

Plattformstekniker har fullständig kontroll över användningen av kataloger på projektnivå. Användning av kataloger på projektnivå måste aktiveras på utvecklingscenternivå innan en katalog kan läggas till i ett projekt. Plattformstekniker kan också konfigurera vilka typer av katalogobjekt, till exempel miljödefinitioner, som kan användas på projektnivå.

Som standard är användningen av kataloger på projektnivå inaktiverad och ingen av katalogobjekttyperna är aktiverade. Miljödefinitioner från en katalog på projektnivå synkroniseras och kan användas under två villkor. Först måste du aktivera projektbaserade kataloger på motsvarande utvecklingscenternivå. För det andra måste du aktivera användningen av miljödefinitioner för projektet.

Lägga till en katalog i ett projekt

Du måste aktivera kataloger på projektnivå på utvecklingscenternivå innan du kan lägga till en katalog i ett projekt. Du bör också aktivera användning av miljödefinitioner på projektnivå.

Så här aktiverar du användning av kataloger på projektnivå på utvecklingscenternivå:

1. Gå till utvecklingscentret i Azure-portalen.

2. I den vänstra menyn går du till Inställningar och väljer Konfiguration.

   

3. I fönstret Kataloger på projektnivå väljer du Aktivera kataloger per projekt och sedan Använd.

   

Så här aktiverar du användning av miljödefinitioner i projektet:

1. Gå till ditt projekt i Azure-portalen.

2. I den vänstra menyn går du till Inställningar och väljer Kataloger.

   

3. På sidan Kataloger väljer du Katalogobjektbehörigheter.

   

4. I fönstret Inställningar för katalogobjekt väljer du Azure-distributionsmiljödefinitioner för att aktivera användning av miljödefinitioner på projektnivå.

   

Nu kan du lägga till en katalog i projektet.

För kataloger som använder en hanterad identitet eller personlig åtkomsttoken (PAT) för autentisering måste du tilldela en hanterad identitet för projektet. För kataloger som använder en PAT måste du lagra PAT i ett nyckelvalv och ge den hanterade identiteten åtkomst till nyckelvalvshemligheten.

Konfigurera en hanterad identitet

Innan du kan koppla en katalog till ett utvecklingscenter eller projekt måste du konfigurera en hanterad identitet, även kallad en hanterad tjänstidentitet (MSI). Du kan koppla antingen en systemtilldelad hanterad identitet (systemtilldelad MSI) eller en användartilldelad hanterad identitet (användartilldelad MSI). Sedan tilldelar du roller till den hanterade identiteten så att utvecklingscentret eller projektet kan skapa miljötyper i din prenumeration och läsa Azure Repos-projektet som innehåller kataloglagringsplatsen.

Om ditt utvecklingscenter eller projekt inte har någon MSI bifogad följer du stegen i Konfigurera en hanterad identitet för att skapa en och tilldela roller för den hanterade identiteten.

Mer information om hanterade identiteter finns i Vad är hanterade identiteter för Azure-resurser?

Lägga till en katalog

Du kan lägga till en katalog från en Azure Repos-lagringsplats eller en GitHub-lagringsplats. Du kan välja att autentisera genom att tilldela behörigheter till en MSI eller med hjälp av en PAT som du lagrar i ett nyckelvalv.

Välj fliken för den typ av lagringsplats och autentisering som du vill använda.

Lagringsplats för Azure-lagringsplatser med MSI

Utför följande uppgifter för att lägga till en katalog:

• Tilldela behörigheter i Azure Repos för den hanterade identiteten.
• Lägg till din lagringsplats som en katalog.

Tilldela behörigheter i Azure Repos för den hanterade identiteten

Du måste ge den hanterade identiteten behörighet till lagringsplatsen i Azure Repos.

1. Logga in på din Azure DevOps-organisation.

   Kommentar

   Din Azure DevOps-organisation måste finnas i samma katalog som Azure-prenumerationen som innehåller ditt utvecklingscenter eller projekt.

2. Välj Organisationsinställningar.

   

3. På sidan Översikt väljer du Användare.

   

4. På sidan Användare väljer du Lägg till användare.

   

5. Slutför Lägg till nya användare genom att ange eller välja följande information och välj sedan Lägg till:

   Name	Värde
   Användare eller tjänstens huvudnamn	Ange namnet på ditt utvecklingscenter eller projekt. När du använder en systemtilldelad MSI anger du namnet på utvecklingscentret eller projektet, inte objekt-ID:t för det hanterade kontot. När du använder en användartilldelad MSI använder du namnet på det hanterade kontot.
   Åtkomstnivå	Välj Grundläggande.
   Lägg till i projekt	Välj det projekt som innehåller lagringsplatsen.
   Azure DevOps-grupper	Välj Projektläsare.
   Skicka e-post inbjudningar (endast till användare)	Avmarkera kryssrutan.

   

Lägga till din lagringsplats som en katalog

Azure Deployment Environments stöder anslutning av Azure Repos-lagringsplatser och GitHub-lagringsplatser. Du kan lagra en uppsättning utvalda IaC-mallar på en lagringsplats. Genom att koppla lagringsplatsen till ett utvecklingscenter eller ett projekt som en katalog får utvecklingsteamen åtkomst till mallarna och gör det möjligt för dem att snabbt skapa konsekventa miljöer.

Med följande steg kan du bifoga en Azure Repos-lagringsplats.

1. I Azure-portalen navigerar du till ditt utvecklingscenter eller projekt.

2. I den vänstra menyn under Miljökonfiguration väljer du Kataloger och sedan Lägg till.

   

3. I Lägg till katalog anger du följande information och väljer sedan Lägg till:

   Fält	Värde
   Namn	Ange ett namn för katalogen.
   Katalogplats	Välj Azure DevOps.
   Autentiseringstyp	Välj Hanterad identitet.
   Organisation	Välj din Azure DevOps-organisation.
   Projekt	I listan över projekt väljer du det projekt som lagrar lagringsplatsen.
   Repo	I listan över lagringsplatser väljer du den lagringsplats som du vill lägga till.
   Gren	Välj grenen.
   Mappsökväg	Dev Box hämtar en lista över mappar i din gren. Välj den mapp som lagrar dina IaC-mallar.

   

4. Kontrollera att katalogen visas i Kataloger för utvecklingscentret eller projektet. När anslutningen lyckas läser statusen Synkronisera lyckades. Det kan ta några minuter att ansluta till en katalog första gången.

Lagringsplats för Azure-lagringsplatser med PAT

Utför följande uppgifter för att lägga till en katalog:

• Hämta klonings-URL:en för azure-lagringsplatsen.
• Skapa en personlig åtkomsttoken (PAT).
• Lagra PAT som en nyckelvalvshemlighet i Azure Key Vault.
• Lägg till din lagringsplats som en katalog.

Hämta klonings-URL:en för azure-lagringsplatsen

1. Gå till startsidan för din gruppsamling (till exempel https://contoso-web-team.visualstudio.com) och välj sedan ditt projekt.

2. Hämta klonings-URL:en för din Azure Repos Git-lagringsplats.

3. Kopiera och spara URL:en.

Skapa en personlig åtkomsttoken i Azure Repos

1. Gå till startsidan för din gruppsamling (till exempel https://contoso-web-team.visualstudio.com) och välj ditt projekt.

2. Skapa en PAT.

3. Kopiera och spara den genererade token som ska användas senare.

Skapa en Key Vault-lösning

Du behöver ett Azure Key Vault för att lagra den PAT som används för att ge Azure åtkomst till din lagringsplats. Nyckelvalv kan styra åtkomsten med antingen åtkomstprinciper eller rollbaserad åtkomstkontroll (RBAC). Om du har ett befintligt nyckelvalv kan du använda det, men du bör kontrollera om det använder åtkomstprinciper eller RBAC-tilldelningar för att kontrollera åtkomsten. Hjälp med att konfigurera en åtkomstprincip för ett nyckelvalv finns i Tilldela en åtkomstprincip för Key Vault.

Använd följande steg för att skapa ett RBAC-nyckelvalv:

1. Logga in på Azure-portalen.

2. Skriv Key Vault i sökrutan.

3. I resultatlistan väljer du Key Vault.

4. På sidan Key Vault väljer du Skapa.

5. På fliken Skapa nyckelvalv anger du följande information:

   Name	Värde
   Namn	Ange ett namn för nyckelvalvet.
   Abonnemang	Välj den prenumeration där du vill skapa nyckelvalvet.
   Resursgrupp	Använd antingen en befintlig resursgrupp eller välj Skapa ny och ange ett namn för resursgruppen.
   Plats	Välj den plats eller region där du vill skapa nyckelvalvet.

   Låt de andra alternativen vara kvar som standard.

6. På fliken Åtkomstprincip väljer du Rollbaserad åtkomstkontroll för Azure och sedan Granska + skapa.

7. På fliken Granska + skapa väljer du Skapa.

Om organisationens principer kräver att du håller ditt Key Vault privat från Internet kan du ställa in ditt Key Vault så att betrodda Microsoft usluge kringgår brandväggsregeln.

Information om hur du tillåter att betrodda Microsoft usluge kringgår brandväggen finns i Konfigurera nätverksinställningar för Azure Key Vault.

Lagra den personliga åtkomsttoken i nyckelvalvet

1. I Key Vault går du till den vänstra menyn och väljer Hemligheter.

2. På sidan Hemligheter väljer du Generera/importera.

3. På sidan Skapa en hemlighet :

   • I rutan Namn anger du ett beskrivande namn för din hemlighet.
   • I rutan Hemligt värde klistrar du in den PAT som du kopierade tidigare.
   • Välj Skapa.

Hämta den hemliga identifieraren

Hämta sökvägen till hemligheten som du skapade i nyckelvalvet.

1. Gå till ditt nyckelvalv i Azure-portalen.

2. På sidan nyckelvalv går du till den vänstra menyn och väljer Hemligheter.

3. På sidan Hemligheter väljer du den hemlighet som du skapade tidigare.

4. På sidan versioner väljer du AKTUELL VERSION.

5. På den aktuella versionssidan väljer du kopiera för hemlighetsidentifieraren.

Lägga till din lagringsplats som en katalog

1. Gå till utvecklingscentret eller projektet i Azure-portalen.

2. Se till att den identitet som är kopplad till utvecklingscentret eller projektet har åtkomst till nyckelvalvshemligheten där din personliga åtkomsttoken lagras.

3. I den vänstra menyn under Miljökonfiguration väljer du Kataloger och sedan Lägg till.

4. I Lägg till katalog anger du följande information och väljer sedan Lägg till:

   Fält	Värde
   Namn	Ange ett namn för katalogen.
   Katalogplats	Välj Azure DevOps.
   Autentiseringstyp	Välj Personlig åtkomsttoken.
   Organisation	Välj den organisation som är värd för katalog-lagringsplatsen.
   Projekt	Välj det projekt som lagrar kataloglagringsplatsen.
   Rep	Välj den lagringsplats som lagrar katalogen.
   Mappsökväg	Välj den mapp som innehåller dina IaC-mallar.
   Hemlig identifierare	Ange den hemliga identifierare som innehåller din PAT för lagringsplatsen. När du kopierar en hemlig identifierare innehåller niska veze en versionsidentifierare i slutet, som i det här exemplet: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Om du tar bort versionsidentifieraren ser du till att Distributionsmiljöer hämtar den senaste versionen av hemligheten från nyckelvalvet. Om din PAT upphör att gälla behöver endast nyckelvalvet uppdateras. Exempel på hemlig identifierare: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Kontrollera att katalogen visas i Kataloger. Om anslutningen lyckas är statusen Ansluten.

DevCenter-app för GitHub-lagringsplats

Utför följande uppgifter för att lägga till en katalog:

1. Installera och konfigurera Microsoft Dev Center-appen
2. Tilldela behörigheter i GitHub för lagringsplatserna.
3. Lägg till din lagringsplats som en katalog.

Installera Microsoft Dev Center-appen

1. Logga in på Azure-portalen.

2. Gå till utvecklingscentret eller projektet.

3. I den vänstra menyn under Miljökonfiguration väljer du Kataloger och sedan Lägg till.

4. I fönstret Lägg till katalog anger du eller väljer följande:

   Fält	Värde
   Namn	Ange ett namn för katalogen.
   Katalogkälla	Välj GitHub.
   Autentiseringstyp	Välj GitHub-app.

5. Om du vill installera Microsoft Dev Center-appen väljer du konfigurera dina lagringsplatser.

   

6. Om du uppmanas att autentisera till GitHub autentiserar du.

7. På sidan Microsoft DevCenter väljer du Konfigurera.

   

8. Välj den GitHub-organisation som innehåller den lagringsplats som du vill lägga till som en katalog. Du måste vara ägare till organisationen för att kunna installera den här appen.

   

9. På sidan Installera Microsoft DevCenter väljer du Endast lagringsplatser, väljer den lagringsplats som du vill lägga till som en katalog och väljer sedan Installera.

   

   Du kan välja flera lagringsplatser att lägga till som kataloger. Du måste lägga till varje lagringsplats som en separat katalog enligt beskrivningen i Lägg till lagringsplatsen som en katalog.

10. På Sidan Microsoft DevCenter från Microsoft vill du ha behörighet att: granska de behörigheter som krävs och välj sedan Auktorisera Microsoft Dev Center.

    

Lägga till din lagringsplats som en katalog

1. Växla tillbaka till Azure Portal.

2. I Lägg till katalog anger du följande information och väljer sedan Lägg till:

   Fält	Värde
   Repo	Välj den lagringsplats som du vill lägga till som en katalog.
   Gren	Välj grenen.
   Mappsökväg	Välj den mapp som innehåller undermappar som innehåller dina miljödefinitioner.

   

3. Kontrollera att katalogen visas i Kataloger. När anslutningen lyckas läser statusen Synkronisera lyckades.

   

GitHub-lagringsplats med PAT

Utför följande uppgifter för att lägga till en katalog:

• Hämta klonings-URL:en för din GitHub-lagringsplats.
• Skapa en personlig åtkomsttoken (PAT) i GitHub.
• Lagra PAT som en nyckelvalvshemlighet i Azure Key Vault.
• Lägg till din lagringsplats som en katalog.

Hämta klonings-URL:en för din GitHub-lagringsplats

1. Gå till startsidan för GitHub-lagringsplatsen som innehåller malldefinitionerna.

2. Hämta url:en för GitHub-lagringsplatsens kloning.

3. Kopiera och spara URL:en.

Skapa en personlig åtkomsttoken i GitHub

Azure Deployment Environments stöder autentisering till GitHub-lagringsplatser med hjälp av antingen klassiska token eller detaljerade token. I det här exemplet skapar du en detaljerad token.

1. Gå till startsidan för GitHub-lagringsplatsen som innehåller malldefinitionerna.

2. I det övre högra hörnet av GitHub väljer du profilbilden och sedan Inställningar.

3. I det vänstra sidofältet väljer du Utvecklarinställningar>Personliga åtkomsttoken>Finkorniga token.

4. Välj Generera ny token.

5. På sidan Ny detaljerad personlig åtkomsttoken anger du följande information:

   Name	Värde
   Tokennamn	Ange ett beskrivande namn för token.
   Upphörande	Välj förfalloperiod för token i dagar.
   Beskrivning	Ange en beskrivning för token.
   Resursägare	Välj lagringsplatsens ägare.
   Åtkomst till lagringsplats	Välj Välj Endast lagringsplatser.
   Välj lagringsplatser	Välj den lagringsplats som innehåller miljödefinitionerna.
   Lagringsplatsbehörigheter	Expandera Lagringsplatsens behörigheter och välj Kodläsning för Innehåll i åtkomstlistan.

   

6. Välj Generera token.

7. Kopiera och spara den genererade token som ska användas senare.

Viktigt!

När du arbetar med en privat lagringsplats som lagras i en GitHub-organisation måste du se till att GitHub PAT har konfigurerats för att ge åtkomst till rätt organisation och lagringsplatser i den.

• Klassiska token i organisationen måste vara auktoriserade för enkel inloggning till den specifika organisationen när de har skapats.
• Detaljerade token måste ha ägaren till token inställd som själva organisationen för att kunna auktoriseras.

Felaktigt konfigurerade PAT:er kan leda till att det inte gick att hitta en lagringsplats.

Skapa en Key Vault-lösning

Du behöver ett Azure Key Vault för att lagra den PAT som används för att ge Azure åtkomst till din lagringsplats. Nyckelvalv kan styra åtkomsten med antingen åtkomstprinciper eller rollbaserad åtkomstkontroll (RBAC). Om du har ett befintligt nyckelvalv kan du använda det, men du bör kontrollera om det använder åtkomstprinciper eller RBAC-tilldelningar för att kontrollera åtkomsten. Mer information om hur du konfigurerar en åtkomstprincip för ett nyckelvalv finns i Tilldela en åtkomstprincip för nyckelvalvet.

Använd följande steg för att skapa ett RBAC-nyckelvalv:

1. Logga in på Azure-portalen.

2. I sökrutan anger du nyckelvalv.

3. I resultatlistan väljer du Key Vault.

4. På sidan Key Vault väljer du Skapa.

5. På fliken Skapa nyckelvalv anger du följande information:

   Name	Värde
   Namn	Ange ett namn för nyckelvalvet.
   Abonnemang	Välj den prenumeration där du vill skapa nyckelvalvet.
   Resursgrupp	Använd antingen en befintlig resursgrupp eller välj Skapa ny och ange ett namn för resursgruppen.
   Plats	Välj den plats eller region där du vill skapa nyckelvalvet.

   Låt de andra alternativen vara kvar som standard.

6. På fliken Åtkomstprincip väljer du Rollbaserad åtkomstkontroll för Azure och sedan Granska + skapa.

7. På fliken Granska + skapa väljer du Skapa.

Om organisationens principer kräver att du håller ditt Key Vault privat från Internet kan du ställa in ditt Key Vault så att betrodda Microsoft usluge kringgår brandväggsregeln.

Information om hur du tillåter att betrodda Microsoft usluge kringgår brandväggen finns i Konfigurera nätverksinställningar för Azure Key Vault.

Lagra den personliga åtkomsttoken i nyckelvalvet

1. I Key Vault går du till den vänstra menyn och väljer Hemligheter.

2. På sidan Hemligheter väljer du Generera/importera.

3. På sidan Skapa en hemlighet :

   • I rutan Namn anger du ett beskrivande namn för din hemlighet.
   • I rutan Hemligt värde klistrar du in din PAT.
   • Välj Skapa.

Hämta den hemliga identifieraren

Hämta sökvägen till hemligheten som du skapade i nyckelvalvet.

1. Gå till ditt nyckelvalv i Azure-portalen.

2. På sidan nyckelvalv går du till den vänstra menyn och väljer Hemligheter.

3. På sidan Hemligheter väljer du den hemlighet som du skapade tidigare.

4. På sidan versioner väljer du AKTUELL VERSION.

5. På den aktuella versionssidan väljer du kopiera för hemlighetsidentifieraren.

Lägga till din lagringsplats som en katalog

1. Gå till utvecklingscentret eller projektet i Azure-portalen.

2. Se till att den hanterade identitet som är kopplad till utvecklingscentret eller projektet har åtkomst till nyckelvalvshemligheten där din personliga åtkomsttoken lagras.

3. I den vänstra menyn under Miljökonfiguration väljer du Kataloger och sedan Lägg till.

4. I Lägg till katalog anger du följande information och väljer sedan Lägg till.

   Fält	Värde
   Namn	Ange ett namn för katalogen.
   Katalogplats	Välj GitHub.
   Repo	Ange eller klistra in klonings-URL:en för din GitHub-lagringsplats eller din Azure Repos-lagringsplats. Exempel på katalogexempel: https://github.com/Azure/deployment-environments.git
   Gren	Ange den lagringsplatsgren som du vill ansluta till. Exempel på katalogexempel: main
   Mappsökväg	Ange mappsökvägen i förhållande till den klonade URI:n som innehåller undermappar som innehåller dina miljödefinitioner. Mappsökvägen är för mappen med undermappar som innehåller miljödefinitionsmiljöfiler, inte för mappen med själva miljödefinitionsmiljöfilen. Följande bild visar mappstrukturen för exempelkatalogen. Exempel på katalogexempel: /Environments Mappsökvägen kan börja med eller utan snedstreck (/).
   Hemlig identifierare	Ange den hemliga identifierare som innehåller din PAT för lagringsplatsen. När du kopierar en hemlig identifierare innehåller niska veze en versionsidentifierare i slutet, som i det här exemplet: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Om du tar bort versionsidentifieraren ser du till att distributionsmiljöer hämtar den senaste versionen av hemligheten från nyckelvalvet. Om din PAT upphör att gälla behöver endast nyckelvalvet uppdateras. Exempel på hemlig identifierare: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Kontrollera att katalogen visas i Kataloger. När anslutningen lyckas läser statusen Synkronisera lyckades.

Visa synkroniserade katalogobjekt

Oavsett vilken typ av lagringsplats du använder kan du visa katalogobjekten som synkroniseras från katalogen.

1. Välj Kataloger under Miljökonfiguration på den vänstra menyn för ditt utvecklingscenter eller projekt.

2. I fönstret Kataloger väljer du katalognamnet.

   

3. Du ser en lista över katalogobjekt som har synkroniserats.

   

Uppdatera en katalog

Om du uppdaterar definitionen eller mallinnehållet på den anslutna lagringsplatsen kan du ange den senaste uppsättningen miljödefinitioner till utvecklingsteamen genom att synkronisera katalogen. Du kan synkronisera en katalog manuellt eller automatiskt.

Synkronisera en katalog manuellt

När du synkroniserar en katalog manuellt genomsöker Distributionsmiljöer via lagringsplatsen och gör den senaste listan med miljödefinitioner tillgänglig för alla associerade projekt i utvecklingscentret.

1. På den vänstra menyn för utvecklingscentret går du till Miljökonfiguration och väljer Kataloger.

2. Välj den specifika katalogen och välj sedan Synkronisera i kommandofältet.

   

Synkronisera en katalog automatiskt

När du konfigurerar en katalog så att den synkroniseras automatiskt genomsöker Distributionsmiljöer via lagringsplatsen var 30:e minut och gör den senaste listan över miljödefinitioner tillgänglig för alla associerade projekt i utvecklingscentret.

1. Välj Kataloger under Miljökonfiguration på den vänstra menyn för ditt utvecklingscenter eller projekt.

2. Välj den specifika katalogen och välj sedan redigera.

   

3. I fönstret Redigera katalog väljer du Synkronisera katalogen automatiskt och väljer sedan Spara.

   

Ta bort en katalog

Du kan ta bort en katalog för att ta bort den från Utvecklingscentret eller projektet för Azure Deployment Environments. Mallar i en borttagen katalog är inte tillgängliga för utvecklingsteam när de distribuerar nya miljöer. Uppdatera referensen för miljödefinitionen för alla befintliga miljöer som har skapats med hjälp av miljödefinitionerna i den borttagna katalogen. Om referensen inte uppdateras och miljön distribueras igen misslyckas distributionen.

Så här tar du bort en katalog:

1. Välj Kataloger under Miljökonfiguration på den vänstra menyn för ditt utvecklingscenter eller projekt.

2. Välj den specifika katalogen och välj sedan Ta bort.

3. I dialogrutan Ta bort katalog väljer du Fortsätt för att ta bort katalogen.

Felsöka katalogsynkroniseringsfel

När du lägger till eller synkroniserar en katalog kan det uppstå ett synkroniseringsfel eller en varning. Ett synkroniseringsfel anger att en katalog inte kunde synkroniseras. En synkroniseringsvarning anger att vissa eller alla katalogobjekt har fel. Du kan visa synkroniseringsstatus och -fel i Azure-portalen eller använda Azure CLI och REST API för att felsöka och lösa felen.

Visa katalogsynkroniseringsstatus

I Azure-portalen kan du få mer information om katalogsynkroniseringsstatus och eventuella varningar eller fel genom att välja statuslänken. Statuslänken öppnar ett fönster som visar synkroniseringsstatus, antalet miljödefinitioner som har lagts till och antalet miljödefinitioner som ignorerades eller misslyckades.

Visa katalogsynkroniseringsfel

1. Välj Kataloger under Miljökonfiguration på den vänstra menyn för ditt utvecklingscenter eller projekt.

2. I kolumnen Status väljer du statuslänken för katalogen som inte kunde synkroniseras.

   

3. Du ser ett informationsfönster som visar ändringarna i den senaste synkroniseringen, antalet synkroniseringsfel och typen av fel.

   

Visa katalogsynkroniseringsvarningar

1. Välj Kataloger under Miljökonfiguration på den vänstra menyn för ditt utvecklingscenter eller projekt.

2. I kolumnen Status väljer du statuslänken för katalogen som synkroniserades men rapporterar en varning.

   

3. Du ser ett informationsfönster som visar ändringarna i den senaste synkroniseringen, antalet objektfel och typen och källan för varje fel.

   

4. Du kan visa objekt som har synkroniserats från en katalog som även rapporterar synkroniseringsfel. Välj katalognamnet i fönstret Kataloger .

   

5. Du ser en lista över katalogobjekt som har synkroniserats.

   

Felsöka katalogsynkroniseringsfel med hjälp av Azure CLI

Använd Azure CLI eller REST-API:et för att hämta katalogen. GET-svaret visar typen av fel:

• Ignorerade miljödefinitioner som identifierades som dubbletter.
• Ogiltiga miljödefinitioner som misslyckades på grund av schema-, referens- eller valideringsfel.

Lösa fel med ignorerad miljödefinition

Ett ignorerat miljödefinitionsfel uppstår om du lägger till två eller flera miljödefinitioner som har samma namn. Du kan lösa det här problemet genom att byta namn på miljödefinitioner så att varje miljödefinition har ett unikt namn i katalogen.

Lösa ogiltiga miljödefinitionsfel

Ett ogiltigt miljödefinitionsfel kan inträffa av olika orsaker:

• Manifestschemafel. Kontrollera att miljödefinitionsmiljöfilen matchar det obligatoriska schemat.

• Valideringsfel. Kontrollera följande objekt för att lösa valideringsfel:

  • Kontrollera att miljöfilens motortyp är korrekt konfigurerad.
  • Kontrollera att miljödefinitionsnamnet är mellan 3 och 63 tecken.
  • Kontrollera att miljödefinitionsnamnet endast innehåller tecken som är giltiga för en URL, som är alfanumeriska tecken och dessa symboler: ~ ! , . ' ; : = - _ + ( ) * & $ @

• Referensfel. Kontrollera att mallsökvägen som miljöfilen refererar till är en giltig relativ sökväg till en fil på lagringsplatsen.

Relaterat innehåll

• Konfigurera miljötyper för ett utvecklingscenter
• Skapa och konfigurera ett projekt med hjälp av Azure CLI
• Konfigurera projektmiljötyper