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.
Een externe opslagplaats configureren
De configuratie van een externe opslagplaats in Cloud Manager bestaat uit de volgende stappen:
- voeg een externe bewaarplaatsaan een geselecteerd programma toe
- Koppel een gevalideerde externe opslagruimte aan een pijpleiding
- vorm een webhaakaan een externe bewaarplaats.
Een externe opslagplaats toevoegen add-ext-repo
-
Logboek in Cloud Manager bij my.cloudmanager.adobe.comen selecteer de aangewezen organisatie.
-
Op de Mijn console van Programma's, selecteer het programma waaraan u een externe bewaarplaats wilt verbinden.
-
In het zijmenu, onder Programma, klik
-
Vlak de hoger-juiste hoek van de pagina van Bewaarplaatsen, klik toevoegen Bewaarplaats.
-
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.
-
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
ofhttps://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. -
Selecteer sparen om de bewaarplaats toe te voegen.
Geef nu een toegangstoken om de eigendom van de externe opslagplaats te valideren.
-
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 Bitbucket (voor illustratie slechts).
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 |
|
Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.
Zie ook de Tokens van de Toegang beheren.
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 |
|
Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.
Zie ook de Tokens van de Toegang beheren.
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 |
|
Na bevestiging, is de externe bewaarplaats klaar om aan een pijpleiding te gebruiken en te verbinden.
Zie ook de Tokens van de Toegang beheren.
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 |
|
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
-
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, -
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.
-
In de drop-down lijst van de Tak van 0} Git, selecteer de tak als bron voor de pijpleiding.
-
Klik sparen.
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:
-
Logboek in Cloud Manager bij my.cloudmanager.adobe.comen selecteer de aangewezen organisatie.
-
Op de Mijn console van Programma's, selecteer het programma waaraan u een webhaak voor een externe bewaarplaats van het Git wilt vormen.
-
In de upper-left hoek van de pagina, klik
-
In het linkerzijmenu, onder de rubriek van het Programma, klik
-
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
-
Van het drop-down menu, klik Config Webhaak.
-
In het de dialoogvakje van WebHaak van Config, doe het volgende:
- Naast het gebied van URL van de Webhaak, klik
Plak de URL in een tekstbestand zonder opmaak. De gekopieerde URL is vereist voor de WebHaak-instellingen van uw Git-leverancier. - Naast het Geheime 1} teken/zeer belangrijke gebied van Webhaak {, klik produceren, dan klik pictogram van het Exemplaar
- Naast het gebied van URL van de Webhaak, klik
Plak het geheim in een tekstbestand zonder opmaak. Het gekopieerde geheim wordt vereist voor de montages Webhaak van uw verkoper van het Git.
-
Klik dicht.
-
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.
-
Bepaal de plaats van de sectie van de Montages van Webhaak van de oplossing.
-
Plak de URL van de Webhaak die u eerder hebt gekopieerd in het URL-tekstveld.
-
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.
-
-
Plak het Geheim WebHaak dat u vroeger in het Geheime (of Geheime sleutel, of Geheime teken) tekstgebied kopieerde.
-
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.
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.
|
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).
|
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.
|
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.
Plaats authentificatie: |
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.
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:
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 validatie van koude kwaliteit is voltooid:
Wanneer validatie van de codekwaliteit mislukt vanwege een fout:
Wanneer de validatie van de codekwaliteit mislukt als gevolg van problemen met de klant:
Wanneer de validatie van de codekwaliteit wordt uitgevoerd:
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):
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.