Externe opslagruimten toevoegen in Cloud Manager external-repositories

Leer hoe u een externe opslagplaats aan Cloud Manager kunt toevoegen. Cloud Manager ondersteunt integratie met GitHub Enterprise-, GitLab- en Bitbucket-opslagruimten.

Klanten kunnen nu ook hun Azure DevOps (Beta) Git-opslagruimten in Cloud Manager opnemen, met ondersteuning voor zowel moderne Azure DevOps- als oudere VSTS-opslagruimten (Visual Studio Team Services).

  • Voor Edge Delivery Services-gebruikers kan de ingebouwde opslagplaats worden gebruikt voor het synchroniseren en implementeren van sitecode.
  • Voor AEM as a Cloud Service- en Adobe Managed Services-gebruikers (AMS) kan de opslagplaats worden gekoppeld aan zowel full-stack als frontend pijpleidingen.
NOTE
De ondersteuning die is toegevoegd voor Azure DevOps die in dit artikel wordt beschreven, is alleen beschikbaar via het persoonlijke bètaprogramma. Voor meer details en om omhoog voor bèta te ondertekenen, zie Uw Eigen Gitbrengen.

Een externe opslagplaats configureren

De configuratie van een externe opslagplaats in Cloud Manager bestaat uit de volgende stappen:

Een externe opslagplaats toevoegen add-ext-repo

NOTE
Externe opslagplaatsen kunnen niet worden gekoppeld aan configuratiepijpleidingen.
  1. Logboek in Cloud Manager bij my.cloudmanager.adobe.comen selecteer de aangewezen organisatie.

  2. Op de Mijn console van Programma's, selecteer het programma waaraan u een externe bewaarplaats wilt verbinden.

  3. In het zijmenu, onder Programma, klik het overzichtspictogram van de Omslag Bewaarplaatsen.

    de pagina van Bewaarplaatsen

  4. Vlak de hoger-juiste hoek van de pagina van Bewaarplaatsen, klik toevoegen Bewaarplaats.

  5. In voeg de dialoogdoos van de Bewaarplaats toe, selecteer Privé Bewaarplaats om een externe bewaarplaats van de Bewaarplaats van de Bewaarplaats aan uw programma te verbinden.

    voeg eigen bewaarplaats toe

  6. Geef in elk veld de volgende gegevens over uw opslagplaats op:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Veld Beschrijving
    Naam van de Bewaarplaats Vereist. Een expressieve naam voor uw nieuwe opslagplaats.
    Repository URL Vereist. De URL van de gegevensopslagruimte.

    als u een GitHub-ontvangen bewaarplaats gebruikt, moet de weg in .git beëindigen.
    bijvoorbeeld, https://github.com/org-name/repo-name.git (De weg URL is slechts voor illustratiedoeleinden).

    als u een externe bewaarplaats gebruikt, moet het het volgende URL wegformaat gebruiken:
    https://git-vendor-name.com/org-name/repo-name.git
    of
    https://self-hosted-domain/org-name/repo-name.git
    en past uw verkoper van het Git aan.
    Uitgezochte Type van Bewaarplaats

    Vereist. Selecteer het type repository dat u gebruikt. Als het URL-pad van de gegevensopslagruimte de naam van de Git-leverancier bevat, zoals GitLab of Bitbucket, is het type gegevensopslagruimte al geselecteerd voor u.:

    • GitHub (Onderneming GitHub en de zelf-ontvangen versie van GitHub)
    • GitLab (zowel gitlab.com als de zelf-ontvangen versie van GitLab)
    • Bitbucket (slechts bitbucket.org - wolkenversie) wordt gesteund. De zelfgehoste versie van Bitbucket is vanaf 15 februari 2024 verouderd.
    • Azure DevOps (dev.azure.com)
    Beschrijving Optioneel. Een gedetailleerde beschrijving van de gegevensopslagruimte.
  7. Selecteer sparen om de bewaarplaats toe te voegen.

    Geef nu een toegangstoken om de eigendom van de externe opslagplaats te valideren.

  8. In het dialoogvakje van de Bevestiging van de Eigendom van de Bewaarplaats 0} Privé, verstrek een toegangstoken om eigendom van de externe bewaarplaats te bevestigen zodat kunt u tot het toegang hebben, dan klik Bevestiging .

    Selecterend een bestaand toegangstoken voor een bewaarplaats
    Selecterend een bestaand toegangstoken voor een bewaarplaats Bitbucket (voor illustratie slechts).

Onderneming GitHub
table 0-row-2 1-row-2 2-row-2
Toegang tot token, optie Beschrijving
het Bestaande Token van de Toegang van het Gebruik Als u al een toegangstoken voor de opslagplaats hebt opgegeven voor uw organisatie en toegang hebt tot meerdere opslagplaatsen, kunt u een bestaand token selecteren. Gebruik de Symbolische Naam drop-down lijst om het teken te kiezen u op de bewaarplaats wilt toepassen. Anders, voeg een nieuw toegangstoken toe.
voeg nieuw Token van de Toegang toe
  • Op het Symbolische de tekstgebied van de Naam, typ een naam voor het toegangstoken u creeert.

  • Creeer een persoonlijk toegangstoken door de instructies in de documentatie GitHubte volgen.

  • De vereiste toestemmingen voor het Token van de Toegang van de Onderneming GitHub Persoonlijke (KLOPJE)
    Deze toestemmingen verzekeren dat Cloud Manager trekverzoeken kan bevestigen, statuscontroles, en toegangsnoodzakelijke repo details beheren.
    wanneer u het KLOPJE in de Onderneming GitHub produceert, zorg ervoor het de volgende bewaarplaatstoestemmingen omvat:

    • Pull request (lezen en schrijven)
    • Statussen vastleggen (lezen en schrijven)
    • Metagegevens opslagplaats (alleen-lezen)
  • Op het Symbolische gebied van de Toegang, kleef het teken u enkel creeerde.

Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.

Zie ook de Tokens van de Toegang beheren.

GitLab
table 0-row-2 1-row-2 2-row-2
Toegang tot token, optie Beschrijving
het Bestaande Token van de Toegang van het Gebruik Als u al een toegangstoken voor de opslagplaats hebt opgegeven voor uw organisatie en toegang hebt tot meerdere opslagplaatsen, kunt u een bestaand token selecteren. Gebruik de Symbolische Naam drop-down lijst om het teken te kiezen u op de bewaarplaats wilt toepassen. Anders, voeg een nieuw toegangstoken toe.
voeg nieuw Token van de Toegang toe
  • Op het Symbolische de tekstgebied van de Naam, typ een naam voor het toegangstoken u creeert.

  • Creeer een persoonlijk toegangstoken door de instructie in de documentatie GitLabte volgen.

  • Vereiste toestemmingen voor het Token van de Toegang van GitLab Persoonlijke (KLOPJE)
    Deze werkingsgebieden staan Cloud Manager toe om tot gegevens van de gegevensopslagplaats en gebruikersinformatie zoals nodig voor bevestiging en WebHaakintegratie toegang te hebben.
    wanneer u het KLOPJE in GitLab produceert, zorg ervoor het het volgende symbolische werkingsgebied omvat:

    • api
    • read_user
  • Op het Symbolische gebied van de Toegang, kleef het teken u enkel creeerde.

Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.

Zie ook de Tokens van de Toegang beheren.

Bitbucket
table 0-row-2 1-row-2 2-row-2
Toegang tot token, optie Beschrijving
het Bestaande Token van de Toegang van het Gebruik Als u al een toegangstoken voor de opslagplaats hebt opgegeven voor uw organisatie en toegang hebt tot meerdere opslagplaatsen, kunt u een bestaand token selecteren. Gebruik de Symbolische Naam drop-down lijst om het teken te kiezen u op de bewaarplaats wilt toepassen. Anders, voeg een nieuw toegangstoken toe.
voeg nieuw Token van de Toegang toe
  • Op het Symbolische de tekstgebied van de Naam, typ een naam voor het toegangstoken u creeert.

  • Creeer een toegangstoken van de bewaarplaats gebruikend de documentatie Bitbucket.

  • De vereiste toestemmingen voor het Symbolische Symbolische Token van de Toegang van de Bitmap Persoonlijke (KLOPJE)
    Deze toestemmingen staan Cloud Manager toe om tot inhoud van de opslagplaats toegang te hebben, trekkingsverzoeken te beheren, en te vormen of op Web-haakgebeurtenissen te reageren.
    wanneer u het toepassingswachtwoord in Bitbucket creeert, zorg ervoor het de volgende vereiste toestemmingen van het toepassingswachtwoord omvat:

    • Opslagplaats (alleen-lezen)
    • Pull-aanvragen (lezen en schrijven)
    • Webhaken (lezen en schrijven)
  • Op het Symbolische gebied van de Toegang, kleef het teken u enkel creeerde.

Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.

Zie ook de Tokens van de Toegang beheren.

Azure DevOps (Beta)
table 0-row-2 1-row-2 2-row-2
Toegang tot token, optie Beschrijving
het Bestaande Token van de Toegang van het Gebruik Als u al een toegangstoken voor de opslagplaats hebt opgegeven voor uw organisatie en toegang hebt tot meerdere opslagplaatsen, kunt u een bestaand token selecteren. Gebruik de Symbolische Naam drop-down lijst om het teken te kiezen u op de bewaarplaats wilt toepassen. Anders, voeg een nieuw toegangstoken toe.
voeg nieuw Token van de Toegang toe
  • Op het Symbolische de tekstgebied van de Naam, typ een naam voor het toegangstoken u creeert.
  • Creeer een toegangstoken van de bewaarplaats gebruikend de Azure documentatie DevOps.
  • Vereiste toestemmingen voor het Azure DevOps Persoonlijke Token van de Toegang (PAT).
    Deze toestemmingen staan Cloud Manager toe om tot bewaarplaatsinhoud toegang te hebben, trekkingsverzoeken te beheren, en te vormen of op WebHaakgebeurtenissen te reageren.
    wanneer u het app wachtwoord in Azure DevOps creeert, zorg ervoor het de volgende vereiste toestemmingen van het toepassingswachtwoord omvat:
    • Opslagplaats (alleen-lezen)
  • Op het Symbolische gebied van de Toegang, kleef het teken u enkel creeerde.

Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.

Zie ook de Tokens van de Toegang beheren.

Koppel een gevalideerde externe opslagruimte aan een pijpleiding validate-ext-repo

  1. Een pijplijn toevoegen of bewerken:

    {de bron van de 0} Opslag van de code van de Pijpleiding en tak van het Git
    voeg de dialoogdoos van de Pijpleiding van de Niet-Productie met geselecteerde bewaarplaats en de tak van het Git toe,

  2. Wanneer het toevoegen van of het uitgeven van een pijpleiding, om de plaats van de Code van Source voor uw nieuwe of bestaande pijpleiding te specificeren, verkies de externe bewaarplaats u van de drop-down lijst van de Bewaarplaats wilt gebruiken.

  3. In de drop-down lijst van de Tak van 0} Git, selecteer de tak als bron voor de pijpleiding.

  4. Klik sparen.

TIP
Voor details over het beheren van bewaarplaatsen in Cloud Manager, zie Bewaarplaatsen van Cloud Manager.

Een webhaak configureren voor een externe gegevensopslagruimte configure-webhook

Met Cloud Manager kunt u webhaken configureren voor externe Git-opslagruimten die u hebt toegevoegd. Zie een externe bewaarplaatstoevoegen. Met deze websites kan Cloud Manager gebeurtenissen ontvangen die gerelateerd zijn aan verschillende acties binnen uw Git-leveranciersoplossing.

Met websites kan Cloud Manager bijvoorbeeld acties activeren op basis van gebeurtenissen zoals de volgende:

  • Creatie van het volledige verzoek (PR) - initieert de functionaliteit voor PR-validatie.
  • Push events - Start pijpleidingen wanneer de trigger "On Git Commit" is ingeschakeld (ingeschakeld).
  • Toekomstige op opmerkingen gebaseerde acties - Hiermee worden workflows mogelijk, zoals directe implementatie van een PR, naar een Rapid Development Environment (RDE).

Webhaconfiguratie is niet vereist voor opslagruimten die op GitHub.com worden gehost, omdat Cloud Manager rechtstreeks via de GitHub-app integreert.

Voor alle andere externe bewaarplaatsen die met een toegangstoken - zoals de Onderneming van GitHub, GitLab, Bitbucket, en Azure DevOps - worden bezet is de webhaakconfiguratie beschikbaar en moet opstelling manueel.

om een webhaak voor een externe bewaarplaats te vormen:

  1. Logboek in Cloud Manager bij my.cloudmanager.adobe.comen selecteer de aangewezen organisatie.

  2. Op de Mijn console van Programma's, selecteer het programma waaraan u een webhaak voor een externe bewaarplaats van het Git wilt vormen.

  3. In de upper-left hoek van de pagina, klik tonen menupictogram om het linkerzijmenu te openbaren.

  4. In het linkerzijmenu, onder de rubriek van het Programma, klik het overzichtspictogram van de Omslag Bewaarplaatsen.

  5. Op de pagina van Bewaarplaatsen, die de kolom van het Type gebruikt om u in uw selectie te begeleiden, van de bewaarplaats de plaats bepalen u wilt, dan klik Ellipse - Meer pictogram naast het.

    de optie Webhaak van Config op drop-down menu voor een geselecteerde bewaarplaats

  6. Van het drop-down menu, klik Config Webhaak.

    vorm de dialoogdoos van Webhaak

  7. In het de dialoogvakje van WebHaak van Config, doe het volgende:

    1. Naast het gebied van URL van de Webhaak, klik pictogram van het Exemplaar .
      Plak de URL in een tekstbestand zonder opmaak. De gekopieerde URL is vereist voor de WebHaak-instellingen van uw Git-leverancier.
    2. Naast het Geheime 1} teken/zeer belangrijke gebied van Webhaak {, klik produceren, dan klik pictogram van het Exemplaar .

Plak het geheim in een tekstbestand zonder opmaak. Het gekopieerde geheim wordt vereist voor de montages Webhaak van uw verkoper van het Git.

  1. Klik dicht.

  2. Navigeer naar uw Git-leveranciersoplossing (GitHub Enterprise, GitLab, Bitbucket of Azure DevOps).

    Alle details op de webshconfiguratie en de gebeurtenissen die voor elke verkoper worden vereist zijn beschikbaar in een externe bewaarplaatstoevoegen. Zie de tabel met tabbladen onder stap 8.

  3. Bepaal de plaats van de sectie van de Montages van Webhaak ​van de oplossing.

  4. Plak de URL van de Webhaak die u eerder hebt gekopieerd in het URL-tekstveld.

    1. Vervang de query-parameter api_key in de URL van de Webhaak door uw eigen echte API-sleutel.

      Als u een API-sleutel wilt genereren, moet u een integratieproject maken in Adobe Developer Console. Zie Creërend een Project van de Integratie APIvoor volledige details.

  5. Plak het Geheim WebHaak dat u vroeger in het Geheime (of Geheime sleutel, of Geheime teken) tekstgebied kopieerde.

  6. Configureer de webhaak om de gebeurtenissen te verzenden die Cloud Manager nodig heeft. Gebruik de volgende lijst om de correcte gebeurtenissen voor uw leverancier van het Git te bepalen.

Onderneming GitHub
table 0-row-1 1-row-1
Vereiste gebeurtenissen van de webhaak

Deze gebeurtenissen staan Cloud Manager toe om aan activiteit te antwoorden GitHub, zoals trekverzoekbevestiging, op duw-gebaseerde trekkers voor pijpleidingen, of de codesynchronisatie van Edge Delivery Services.
zorg ervoor dat de webhaak opstelling is om op de volgende vereiste WebHaakgebeurtenissen teweeg te brengen:

  • Pull-aanvragen
  • Penselen
  • Opmerkingen bij problemen
GitLab
table 0-row-1 1-row-1
Vereiste gebeurtenissen van de webhaak

Met deze webhaakgebeurtenissen kan Cloud Manager pijpleidingen activeren wanneer code wordt geduwd of een samenvoegaanvraag wordt ingediend. Zij volgen ook commentaren met betrekking tot trekverzoekbevestiging (door nota gebeurtenissen).
zorg ervoor dat de webhaak opstelling is om op de volgende vereiste WebHgebeurtenissen teweeg te brengen

  • Push-gebeurtenissen
  • Aanvraaggebeurtenissen samenvoegen
  • Notitie, gebeurtenissen
Bitbucket
table 0-row-1 1-row-1
Vereiste gebeurtenissen van de webhaak

Deze gebeurtenissen zorgen ervoor dat Cloud Manager aantrekverzoeken kan bevestigen, op codeduwen kan antwoorden, en met commentaren voor pijpleidingscoördinatie in wisselwerking staat.
zorg ervoor dat de webhaak opstelling is om op de volgende vereiste WebHgebeurtenissen teweeg te brengen

  • Volledige aanvraag: gemaakt
  • Verzoek tot uittrekken: Bijgewerkt
  • Pull-verzoeken: Samengevoegd
  • Volledige aanvraag: opmerking
  • Repository: Push
Azure DevOps (Beta)
table 0-row-1 1-row-1
Vereiste gebeurtenissen met betrekking tot de webhaak en verificatie

Deze gebeurtenissen zorgen ervoor dat Cloud Manager aantrekverzoeken kan bevestigen, op codeduwen kan antwoorden, en met commentaren voor pijpleidingscoördinatie in wisselwerking staat.
zorg ervoor dat de webhaak opstelling is om op de volgende vereiste WebHgebeurtenissen teweeg te brengen

  • Repository: Push

Plaats authentificatie:
1. Op het Basis gebied van de authentificatiegebruikersbenaming, type cloudmanager.
2. Op het Basis authentificatiewachtwoord gebied, typ het Geheim van Webhaak dat van het gebruikersinterface van Cloud Manager wordt geproduceerd.

Validatie van trekkingsverzoeken met webhaken

Nadat websites correct zijn geconfigureerd, activeert Cloud Manager automatisch pijpleidinguitvoeringen of PR-validatiecontroles voor uw opslagplaats.

Het gedrag is afhankelijk van de Git-provider die u gebruikt, zoals hieronder wordt beschreven.

Onderneming GitHub

Wanneer de controle is gemaakt, lijkt deze op de onderstaande schermafbeelding. Het belangrijkste verschil van GitHub.com is dat GitHub.com controle-looppas gebruikt, terwijl de Onderneming GitHub (die persoonlijke toegangstokens gebruikt) een begaat status produceert:

verbindt status toe om PR validatieproces op Onderneming GitHub te wijzen

GitLab

GitLab-interacties zijn uitsluitend gebaseerd op opmerkingen. Wanneer de validatie begint, wordt een opmerking toegevoegd. Wanneer de validatie is voltooid (of deze is gelukt of mislukt), wordt de eerste opmerking verwijderd en vervangen door een nieuwe opmerking met validatieresultaten of foutdetails.

Wanneer de validatie van de codekwaliteit wordt uitgevoerd:

wanneer de bevestiging van de codekwaliteit loopt

Wanneer validatie van koude kwaliteit is voltooid:

wanneer de koude kwaliteitsbevestiging wordt gebeëindigd

Wanneer validatie van de codekwaliteit mislukt vanwege een fout:

wanneer de bevestiging van de codekwaliteit met een fout ontbreekt

Wanneer de validatie van de codekwaliteit mislukt als gevolg van problemen met de klant:

wanneer de bevestiging van de codekwaliteit wegens klantenkwesties ontbreekt

Bitbucket

Wanneer de validatie van de codekwaliteit wordt uitgevoerd:

Status terwijl de bevestiging van de codekwaliteit loopt

Gebruikt de status commit voor het volgen van voortgang van PR-validatie. In het volgende geval, toont het het schermschot wat gebeurt wanneer een bevestiging van de codekwaliteit wegens een klantenkwestie ontbreekt. Er wordt een opmerking toegevoegd met gedetailleerde foutinformatie en er wordt een commit check gemaakt, die de fout weergeeft (rechts zichtbaar):

Trek de status van de verzoekbevestiging voor Bitbucket

Problemen met webhaken oplossen

  • Zorg ervoor dat de Webhaak-URL een geldige API-sleutel bevat.
  • Controleer of webhaakgebeurtenissen correct zijn geconfigureerd in de instellingen van uw Git-leverancier.
  • Als de bevestiging van PR of pijpleidingstrekkers niet werken, verifieer dat het Geheime Geheime Web in zowel Cloud Manager als uw verkoper van het Git bijgewerkt is.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab