Componenten van ALM-accelerator voor makers instellen

Deze oplossing maakt gebruik van GitHub-acties voor bronbeheer en implementaties. De GitHub-connector wordt gebruikt in stromen om te communiceren met GitHub. Meer informatie: De ALM Accelerator for Makers-componenten gebruiken

Vereisten

Omgevingen

De ALM Accelerator for Makers-componenten beheren de implementatie van oplossingen, van ontwikkeling tot testen tot productieomgevingen. U hebt afzonderlijke omgevingen nodig voor het implementeren van ALM Accelerator for Makers en voor het ontwikkelen, testen en produceren van uw project.

• Creëer een omgeving met een Microsoft Dataverse-database voor het inzetten van ALM Accelerator for Makers.
• Elke doelomgeving (ontwikkeling, test of productie) vereist een Dataverse-database voor het implementeren van oplossingen.
• Maak een GitHub-account op GitHub.com.
• Maak een GitHub-org.

Gebruikers en machtigingen

U hebt de volgende gebruikers en machtigingen nodig in Microsoft Power Platform en Azure Active Directory (Azure AD):

• Een gelicentieerde Power Apps-gebruiker met de rol Systeembeheerder in de omgeving waarin ALM Accelerator for Makers wordt geïmplementeerd.

  Notitie

  Deze gebruiker mag geen meervoudige verificatie hebben ingeschakeld totdat de volledige ondersteuning van serviceprincipals is ingeschakeld in GitHub-werkstromen.

• Een gelicentieerde Azure-gebruiker met machtigingen om app-registraties te maken en toestemming van de beheerder te verlenen voor app-registraties in Azure AD.

• Een GitHub-account op GitHub.com maken

• Een GitHub-organisatie

Een Azure AD-appregistratie maken

Stel een Azure AD-appregistratie die zal worden gebruikt om omgevingen te creëren en oplossingen binnen een omgeving op te halen.

1. Meld u aan bij portal.azure.com.

2. Ga naar Azure Active Directory > App-registraties.

   

3. Selecteer + Nieuwe registratie.

4. Voer GithubDevOpsApp in als naam en selecteer vervolgens Registreren. Laat de andere instellingen ongewijzigd.

5. Selecteer API-machtigingen > +Een machtiging toevoegen.

6. Selecteer Dynamics CRM.

7. Selecteer Gedelegeerde machtigingen en selecteer vervolgens user_impersonation.

   

8. Selecteer Machtigingen toevoegen.

9. Selecteer Beheerderstoestemming geven aan (uw organisatie).

10. Selecteer in het menu de optie Verificatie.

11. Schakel onder Geavanceerde instellingen > Openbare clientstromen toestaan schakelaar De volgende mobiele en desktopstromen inschakelen in.

12. Selecteer Opslaan.

13. Selecteer Overzicht, en kopieer en plak de ID-waarde van de applicatie (client) in Kladblok. U hebt deze waarde nodig in de volgende stap terwijl u de aangepaste connector configureert.

Laat de Azure-portal open, want u moet wat informatie kopiëren wanneer u de aangepaste connector instelt.

De oplossing importeren

1. Download het zipbestand van de ALM Accelerator for Makers-oplossing uit de CoE Starter Kit-repository (aka.ms/CoeStarterKitDownload - download het bestand ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip onder 'Activa').

2. Ga naar make.powerapps.com.

3. Ga naar uw bestemmingsomgeving. In het voorbeeld in de volgende afbeelding importeren we naar de omgeving genaamd Contoso CoE.

   

4. Maak verbindingen met alle connectors die als onderdeel van de oplossing worden gebruikt.

   1. Ga naar Gegevens > Verbindingen.
   2. Selecteer + Nieuwe verbinding.
   3. Zoek naar en selecteer Microsoft Dataverse.
   4. Selecteer + om een verbinding te maken.
   5. Voer dezelfde stappen uit voor de volgende connectors:
      • Office 365 Outlook
      • GitHub
      • Power Apps for Makers
      • Power Platform for Admins
      • Goedkeuring
      • Content Conversion

5. Selecteer Oplossingen in het linkerdeelvenster.

6. Selecteer Importeren. Er wordt een pop-upvenster geopend. (Als het venster niet verschijnt, controleer dan of de pop-upblokkering van uw browser is uitgeschakeld en probeer het opnieuw.)

7. Selecteer in het pop-upvenster Bestand kiezen.

8. Selecteer de ALM Accelerator-oplossing in de Verkenner (ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip).

9. Selecteer als het gecomprimeerde (.zip) bestand is geladen Volgende.

10. Bekijk de informatie en selecteer Volgende.

11. Breng verbindingen tot stand om uw oplossing te activeren. Als u een nieuwe verbinding maakt, moet u Vernieuwen selecteren. U verliest uw voortgang bij het importeren niet.

    

12. Selecteer Importeren.

Configureer omgevingsinstellingen en implementatiefasen na het importeren

1. Ga naar make.powerapps.com.
2. Selecteer Oplossingen in het linkerdeelvenster.
3. Selecteer de oplossing Power Platform GitHub ALM en open de app ALM Accelerator Admin-configuratie.

Implementatiefasen instellen

1. Werk E-mail eigenaar van fase bij voor elk van de drie fasen (DEV, TEST en PROD). De eigenaar van de fase ontvangt een melding voor het goedkeuren van het maken en implementeren van projecten.
2. Werk Gebruikersnaam en wachtwoord van beheerder bij. Deze inloggegevens kunnen een serviceaccount zijn of een gebruikersaccount met de Power Platform-beheerdersrol.
3. Selecteer voor elk van de test- en productiefasen een reeds bestaande omgeving die wordt gebruikt voor test- en productie-implementaties. Uw ontwikkelomgeving is de omgeving die is ingericht toen u begon met het maken van het project.

De waarde van de Webhook-URL bijwerken

Deze URL wordt gebruikt voor callbacks van GitHub.

1. Ga op een nieuw tabblad naar make.powerapps.com > Oplossingen > Power Platform GitHub ALM.
2. Bewerk de stroom WorkflowCompleteNotification.
3. Selecteer de eerste actie en kopieer vervolgens de URL in de actie.
4. Ga terug naar de app ALM Accelerator Admin en werk het veld Webhook-URL bij met de waarde die u in de vorige stap hebt gekopieerd.
5. Selecteer Bijwerken.

De client-id bijwerken

De client-id is nodig voor stromen om een omgeving te creëren en andere beheerdersgerelateerde activiteiten uit te voeren, zoals het ophalen van oplossingen en apps binnen een omgeving.

1. Werk in de ALM Accelerator Admin-app het veld Client-id bij met de waarde van de toepassings-id (client) die u hebt gekopieerd in stap 13 van Een Azure AD-appregistratie maken.
2. Selecteer Bijwerken

Werk de naam van de GitHub-organisatie bij

1. Voer uw GitHub-organisatienaam in (zie voorwaarden, eerder in dit artikel). De opslagplaatsen worden binnen deze organisatie gemaakt.
2. Selecteer Bijwerken.

De taal bijwerken

1. Wijzig desgewenst uw voorkeurstaal. Power Apps gebruikt de IETF BCP-47-indeling voor taaltags, bijvoorbeeld en_US, fr_FR, it_IT.
2. Selecteer Bijwerken.

De instelling voor bestaand GitHub-abonnement bijwerken

Als er een betaald GitHub-abonnement is voor uw organisatie, schakelt u GitHub-abonnement bestaat in.

Veilige beheerdersreferenties

Beveiliging op veldniveau is ingeschakeld om inloggegevens voor implementaties te beveiligen. Als beheerder moet u gebruikers toevoegen aan het veld FieldSecurityForPassword met het veldbeveiligingsprofiel. Dit stelt die gebruikers in staat om hun inloggegevens toe te voegen voor de implementatie van ontwikkelings-, test- en productieomgevingen.

Gebruikers aan veldbeveiligingsprofiel toevoegen

1. Ga naar make.powerapps.com, selecteer Oplossingen en open vervolgens de oplossing Power Platform GitHub ALM.

2. Selecteer FieldSecurityForPassword in de oplossing.

   

3. Selecteer Gebruikers.

   

4. Selecteer Toevoegen.

5. Zoek een gebruiker die u aan het profiel wilt toevoegen.

   

6. Selecteer om de gebruiker toe te voegen aan het beveiligingsprofiel.

   

7. Herhaal deze stap voor alle gebruikers die de ALM Accelerator for Makers-app zullen gebruiken.

8. Selecteer Opslaan en sluiten.

   

GitHub-geheimen voor organisatie configureren

Geheimen voor GitHub-org worden gebruikt voor API-aanroepen om oplossingen te importeren en te exporteren, en om te communiceren met Dataverse. Geheimen zijn de aanbevolen manier om gevoelige informatie op te slaan.

GitHub ondersteunt organisatiegeheimen en geheimen op opslagplaatsniveau. Als u een betaald abonnement hebt, worden alle geheimen die op organisatieniveau zijn gemaakt, ook door privé-opslagplaatsen gebruikt. Dat is het voordeel van een betaald abonnement. Anders moet de beheerder geheimen maken voor elke opslagplaats.

Meer informatie: Aanbiedingen voor GitHub-team.

Betaald abonnement voor GitHub-organisatie

Als u een betaald abonnement voor de GitHub-organisatie hebt, configureert u als volgt organisatiegeheimen:

1. Ga naar uw organisatie in GitHub (https://github.com/yourorg).
2. Selecteer Instellingen > Geheim > Nieuw organisatiegeheim
3. Voer DEV_ENVIRONMENT_SECRET in als de naam voor uw ontwikkelingsimplementatiefase en voer de waarde in voor uw geheim.
4. In de lijst Toegang tot opslagplaats selecteert u Privéopslagplaatsen.
5. Selecteer Geheim toevoegen.
6. Herhaal de voorgaande stappen om TEST_ENVIRONMENT_SECRET en PROD_ENVIRONMENT_SECRET toe te voegen.

Gratis abonnement voor GitHub-organisatie

Als u geen betaald abonnement voor de GitHub-organisatie hebt, doe dan het volgende voor alle projecten die zijn gemaakt in de ALM Accelerator for Makers-app.

1. Ga naar uw organisatie in GitHub (https://github.com/yourorg).
2. Selecteer Instellingen > Geheim > Nieuw organisatiegeheim
3. Voer DEV_ENVIRONMENT_SECRET in als de naam voor uw ontwikkelingsimplementatiefase en voer de waarde in voor uw geheim.
4. Selecteer Geheim toevoegen.
5. Herhaal de voorgaande stappen om TEST_ENVIRONMENT_SECRET en PROD_ENVIRONMENT_SECRET toe te voegen.

U kunt nu werken met de ALM Accelerator for Makers-componenten.