Een Azure DevOps Repo verbinden

Orbit implementeert vanuit Azure Repos, de git-hosting in Azure DevOps. Verbind eenmalig, kies een repository, en elke push wordt gebouwd en gaat live. Deze handleiding behandelt beide verbindingsmethoden, het selecteren van een repository, en de twee zaken die Azure anders doet dan de andere providers.

Twee manieren om verbinding te maken, en waarom er twee zijn

Azure DevOps-organisaties kunnen toepassingen van derden op tenantniveau blokkeren, en veel bedrijven doen dat. Als uw organisatie dat doet, kan de aanmeldingsknop niet voor u werken, wat we ook proberen, dus Orbit biedt een tweede deur die altijd werkt.

• Aanmelden met Microsoft. Één klik, niets om te kopiëren en plakken. Beschikbaar wanneer uw organisatie toepassingen van derden toestaat.
• Persoonlijk toegangstoken. Werkt voor elke organisatie, ook voor organisaties die toepassingen blokkeren. U plakt een organisatienaam en een token die u in Azure DevOps maakt.

Beide deuren bereiken exact dezelfde functies. Geen van beide is een gereduceerde versie van de ander.

Voordat u begint

Optie A: Aanmelden met Microsoft

1. Klik in KPanel op Orbit in de linker zijbalk.
2. Klik op Nieuw project.
3. Laat de modus ingesteld op Git Repo importeren.
4. Kies het tabblad Azure DevOps en klik op Azure DevOps verbinden.

U wordt naar Microsoft gestuurd om u aan te melden en toegang goed te keuren. Keur het goed en u keert terug naar KPanel met uw repositories geladen.

Als uw organisatie de toepassing blokkeert, weigert Microsoft en toont KPanel de reden die het gaf. Dit is iets waar u niet doorheen kunt proberen: gebruik het persoonlijke toegangstoken hieronder, of vraag een beheerder om de toepassing toe te staan.

Optie B: Persoonlijk toegangstoken

Maak het token eerst in Azure DevOps.

1. Open in Azure DevOps Gebruikersinstellingen, vervolgens Persoonlijke toegangstokens, vervolgens Nieuw token.
2. Kies de organisatie waaruit u wilt implementeren.
3. Verlenen deze drie bereiken en niet meer dan deze drie:
   • Code (Lezen) zodat Orbit uw repositories kan weergeven en de commit die het bouwt kan downloaden.
   • Code (Status) zodat het bouwresultaat verschijnt op de commit en op de pull request.
   • Service Hooks (Lezen en schrijven) zodat Orbit zich kan abonneren op uw pushes.
4. Kopieer het token. Azure toont het eenmalig.

Vervolgens in KPanel:

1. Open Orbit, vervolgens Nieuw project, vervolgens het tabblad Azure DevOps.
2. Voer onder Verbinden met een persoonlijk toegangstoken uw organisatienaam in. Dit is het gedeelte van uw repository-adres direct na dev.azure.com, dus voor https://dev.azure.com/contoso/web-platform/_git/storefront is de organisatie contoso.
3. Plak het token en klik op Azure DevOps verbinden.

Orbit gebruikt het token onmiddellijk om uw repositories weer te geven. Als het wordt geweigerd, wordt u verteld welke bereiken ontbreken in plaats van gevraagd om uw token te controleren, omdat een token dat repositories kan weergeven maar geen service hook kan maken, op die manier schoon verbindt en vervolgens nooit iets implementeert.

Uw token wordt versleuteld opgeslagen en wordt alleen gebruikt tegen de organisatie die u heeft genoemd.

Een repository selecteren

Uw repositories verschijnen als een lijst, genoemd organisation / project / repository. Azure-repositories bestaan uit drie delen, niet twee, omdat twee projecten in één organisatie elk een repository kunnen bevatten met dezelfde naam.

Klik op Selecteren naast degene die u wilt, en voltooiend het project als gebruikelijk: naam, framework, bouwinstellingen, omgevingsvariabelen.

Als een repository ontbreekt

• Controleer de organisatie. Een persoonlijk toegangstoken hoort bij ÉÉN organisatie, dus een repository in een andere organisatie verschijnt niet. Verbind die organisatie ook.
• Controleer uw toegang tot de repository zelf in Azure DevOps.
• Controleer of de repository in Azure is uitgeschakeld. Orbit geeft uitgeschakelde repositories niet weer, omdat deze niet kunnen worden gebouwd.

Twee zaken die Azure anders doet

Dit zijn echte verschillen, geen gaten die we nog niet hebben aangepakt, en beide worden hier vermeld in plaats van later te ontdekken.

Monorepo-hoofdmap slaat pushes niet over

Bij de andere providers leest Orbit de lijst met bestanden die elke push veranderde, en een monorepo-project kan een build overslaan wanneer niets onder de hoofdmap is verplaatst. Azure stuurt die lijst niet. Orbit bouwt daarom bij elke push in plaats van te raden, omdat het raden in de andere richting stillekens implementaties zou overslaan die u verwachtte.

Uw instelling voor de hoofdmap bepaalt nog steeds waar de build wordt uitgevoerd. Het filtert alleen niet welke pushes extra maken.

Pull requests van forks worden niet gebouwd

Orbit bouwt een preview van een pull request met de omgevingsvariabelen van uw Preview-omgeving. Dit is veilig voor een pull request uit uw eigen repository en het is niet veilig voor een pull request van een fork, wat een voorstel is van iemand zonder relatie tot uw account.

Op GitHub kan Orbit een fork-preview aanbieden omdat GitHub de voorgestelde commit in uw eigen repository publiceert, zodat we nooit tegen de kopie van de medewerker hoeven te authenticeren. Azure publiceert geen gelijkwaardige, dus Orbit weigert fork pull requests en zegt dit op de commit in plaats van een preview achter te laten die nooit verschijnt.

Pull requests van branches in uw eigen repository worden normaal gebouwd.

Wat gebeurt er vervolgens

Push naar uw productiebranch en Orbit bouwt en implementeert. Het bouwresultaat wordt teruggeplaatst op de commit in Azure DevOps, zodat het op de commit en op elke pull request waartoe de commit behoort verschijnt, en uw branchbeleid kan het vereisen.

Zie ook

• Wat is Orbit?
• Uw Project Implementeren
• Een GitHub Repo verbinden