Konfigurera ALM Accelerator för tillverkarkomponenter

I den här lösningen används GitHub-åtgärder för källkontroll och distributioner. GitHub-anslutningsprogram används i flöden för att interagera med GitHub. Mer information: Använd ALM Accelerator för tillverkarkomponenter

Förutsättningar

Miljöer

ALM Accelerator för tillverkarkomponenter distribuerar lösningar från utveckling till testning till produktionsmiljöer. Du behöver separata miljöer för att distribuera ALM Accelerator för tillverkare och för utveckling, testning och produktion av ditt projekt.

• Skapa en miljö med en Microsoft Dataverse databas för distribution av ALM Accelerator för tillverkare.
• För alla målmiljöer (utveckling, test eller produktion) krävs en Dataverse databas för distribution av lösningar.
• Skapa GitHub-konto på GitHub.com.
• Skapa ett GitHub org.

Användare och behörigheter

Du behöver följande användare och behörigheter i Microsoft Power Platform och Azure Active Directory (Azure AD):

• En licensierad Power Apps användare med rollen Systemadministratör i den miljö där ALM Accelerator för tillverkare kommer att användas.

  Anteckning

  Den här användaren måste inte ha aktiverat autentisering med flera autentiseringar förrän fullt stöd för tjänsthuvuden har aktiverats i GitHub-arbetsflöden.

• En licensierad Azure-användare med behörighet att skapa appregistreringar och ge admin godkännande till appregistreringar i Azure AD.

• Ett GitHub-konto på GitHub.com

• En GitHub-organisation

Skapa en Azure AD-appregistrering

Konfigurera en Azure AD-appregistrering som ska användas för att skapa miljöer och hämta lösningar i en miljö.

1. Logga in på portal.azure.com.

2. Gå till Azure Active Directory > Appregistreringar.

   

3. Välj + Ny registrering.

4. Skriv GithubDevOpsApp för namnet och välj sedan Registrera. Ändra inga andra inställningar.

5. Välj API-behörigheter > + Lägg till en behörighet.

6. Markera Dynamics CRM.

7. Välj Delegerade behörigheter och välj user_impersonation.

   

8. Välj Lägg till behörigheter.

9. Välj Bevilja administratörsmedgivande för [din organisation].

10. Markera Autentisering på kommandomenyn.

11. Under Avancerade inställningar > Tillåt offentliga klientflöden, aktiverar du växlingen Aktivera följande mobila och datorflöden.

12. Välj Spara.

13. Välj Översikt och kopiera och klistra in appvärdet (klient) ID i Anteckningar. Du behöver det här värdet i nästa steg när du konfigurerar det anpassade anslutningsprogrammet.

Låt Azure-portalen vara öppen eftersom du måste kopiera viss information när du anpassar den anpassade anslutningen.

Importera lösningen

1. Ladda ner zip-filen för ALM Accelerator for Makers lösning från CoE startpaket (aka.ms/CoeStarterKitDownload - hämta fil ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip under "Tillgångar").

2. Gå till make.powerapps.com.

3. Gå till dina målmiljöer. I exemplet i följande bild importerar vi till miljön Contoso CoE.

   

4. Skapa anslutningar till alla anslutningsprogram som används som en del av lösningen.

   1. Gå till Data > Anslutningar.
   2. Välj + Ny anslutning.
   3. Sök efter och markera Microsoft Dataverse.
   4. Välj + för att skapa en anslutning.
   5. Slutför samma steg för följande kopplingar:
      • Office 365 Outlook
      • GitHub
      • Power Apps for Makers
      • Power Platform for Admins
      • Godkännande
      • Content Conversion

5. Välj Lösningar i vänstra fönstret.

6. Välj Importera. Ett popup-fönster öppnas. (Om fönstret inte visas kontrollerar du att popup-blockeraren i webbläsaren är inaktiverad innan du försöker igen.)

7. I popup-fönstret väljer du Välj fil.

8. Välj ALM Accelerator-lösningen i Utforskaren (ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip).

9. När den komprimerade filen (.zip) har lästs in väljer du Nästa.

10. Granska informationen och välj sedan Nästa.

11. Upprätta anslutningar för att aktivera din lösning. Om du skapar en ny anslutning måste du välja uppdatera. Du förlorar inte importförloppet.

    

12. Välj Importera.

Konfigurera miljöinställningar och distributionsstadier efter import

1. Gå till make.powerapps.com.
2. Välj Lösningar i vänstra fönstret.
3. Välj lösningen Power Platform GitHub ALM och öppna appen Konfiguration av ALM Accelerator-administration.

Ange distributionsstadier

1. Uppdatera e-postmeddelandet för stadiets ägare för de tre stegen (DEV, TEST och PROD). Stadiets ägare får ett meddelande om godkännande av att ett projekt skapas och distribueras.
2. Uppdatera Administratörens användarnamn och lösenord. Autentiseringsuppgifterna kan vara ett tjänstkonto eller ett användarkonto med Power Platform administratörsrollen.
3. Välj en befintlig miljö som ska användas för test- och produktionsdistributioner för varje test- och produktionsstadier. Din utvecklingsmiljö är den miljö som tillhandahålls när du först skapar ett projekt.

Uppdatera webhook-URL-värdet

URL:en används för återanrop från GitHub.

1. På en ny flik går du till make.powerapps.com > Lösningar > Power Platform GitHub ALM lösning.
2. Redigera flödet WorkflowCompleteNotification.
3. Markera den första åtgärden och kopiera sedan URL-adressen i åtgärden.
4. Gå tillbaka till appen ALM Accelerator administration och uppdatera fältet Webhook Url med det värde du kopierade i föregående steg.
5. Välj Uppdatera.

Uppdatera klient-ID

Klient-ID behövs för flöden för att skapa en miljö och utföra andra adminrelaterade aktiviteter som hämtning av lösningar och appar i en miljö.

1. I administrationsappen ALM Accelerator, uppdatera fältet Klient-ID med hjälp av det appvärde (klient) ID du kopierade i steg 13 av Skapa en Azure AD appregistrering.
2. Välj Uppdatera

Uppdatera GitHub organisationsnamn

1. Ange ditt GitHub organisationsnamn (se krav, tidigare i den här artikeln). Lagringsplatsen skapas i den här organisationen.
2. Välj Uppdatera.

Uppdatera språket

1. Ändra önskat språk om du vill. Power Apps använder IETF-BCP-47 språktaggformat exempel en_US, fr_FR, it_IT.
2. Välj Uppdatera.

Uppdatera inställningen GitHub-planen finns

Om det finns en GitHub org. plan för din organisation aktiverar du växlingen GitHub-plan finns.

Säker administratörsinformation

Säkerhet på fältnivå aktiveras för att säkerställa autentiseringsuppgifter för distributioner. Som administratör måste du lägga till användare i fältsäkerhetsprofilen FieldSecurityForPassword. Detta gör det möjligt för dessa användare att lägga till sina referenser för distributionen från utveckling till test- och produktionsmiljöer.

För att lägga till användare i en fältsäkerhetsprofil

1. Gå till make.powerapps.com, välj Lösningar och öppna sedan lösningen Power Platform GitHub ALM.

2. Välj FieldWordForPassword i lösningen.

   

3. Välj Användare.

   

4. Markera Lägg till.

5. Sök efter en användare som du vill lägga till i profilen.

   

6. Välj för att lägga till användaren i säkerhetsprofilen.

   

7. Upprepa detta steg för alla användare som kommer att använda appen ALM Accelerator för tillverkare.

8. Välj Spara och stäng.

   

Konfigurera GitHub-organisationens hemligheter

GitHub-organisationens hemligheter används för att ringa API-samtal för att importera och exportera lösningar, och för att interagera med Dataverse. Hemligheter är det rekommenderade sättet att lagra känslig information.

GitHub stöder organisationens hemligheter och hemligheter på databasnivå. Om du har en betald plan kan även alla hemligheter som skapats på organisationsnivå användas i privata databaser. Det är fördelen med att ha en betald plan. Annars måste administratören skapa hemligheter för varje förvaringsplats.

Läs mer: GitHub Team-erbjudanden.

Betald GitHub-organisationsplan

Om du har en betald GitHub-organisationsplan måste du konfigurera organisationens hemligheter genom att följa stegen nedan:

1. Gå till din organisation GitHub (https://github.com/yourorg).
2. Välj Inställningar> Hemlighet> Ny organisationshemlighet
3. Ange DEV_ENVIRONMENT_SECRET som namnet på utvecklingsstadiet för din utveckling och ange värdet för din hemlighet.
4. I listan Lagringsplatsåtkomst, välj Privata lagringsplatser.
5. Välj Lägg till hemlighet.
6. Upprepa föregående steg om du vill lägga till en TEST_ENVIRONMENT_SECRET och PROD_ENVIRONMENT_SECRET.

Kostnadsfri GitHub-organisationsplan

Om du inte har en betald GitHub organisationsplan kan du göra följande för alla projekt som skapats i appen ALM Accelerator för tillverkare.

1. Gå till din organisation GitHub (https://github.com/yourorg).
2. Välj Inställningar > Hemlighet > Ny organisationshemlighet
3. Ange DEV_ENVIRONMENT_SECRET som namnet på utvecklingsstadiet för din utveckling och ange värdet för din hemlighet.
4. Välj Lägg till hemlighet.
5. Upprepa föregående steg om du vill lägga till en TEST_ENVIRONMENT_SECRET och PROD_ENVIRONMENT_SECRET.

Du kan nu Använda ALM Accelerator för tillverkarkomponenter.