Oefening: Uw Azure DevOps-omgeving instellen

  • 8 minuten

In deze les zorgt u ervoor dat uw Microsoft Azure DevOps-organisatie is ingesteld om de rest van deze module te voltooien.

Hiervoor moet u het volgende doen:

  • Een Azure DevOps-project instellen voor deze module.
  • Verplaats het werkitem voor deze module op Azure Boards naar de kolom Uitvoeren .
  • Zorg ervoor dat uw project lokaal is ingesteld, zodat u wijzigingen naar de pijplijn kunt pushen.

Het Azure DevOps-project ophalen

Hier zorgt u ervoor dat uw Azure DevOps-organisatie is ingesteld om de rest van deze module te voltooien. U doet dit door een sjabloon uit te voeren waarmee u een project maakt in Azure DevOps.

De modules in dit leertraject vormen een progressie, waar u het Tailspin-webteam door hun DevOps-reis volgt. Voor leerdoeleinden heeft elke module een gekoppeld Azure DevOps-project.

De sjabloon uitvoeren

Voer een sjabloon uit waarmee uw Azure DevOps-organisatie wordt ingesteld.

Belangrijk

De Azure DevOps-demogenerator wordt niet meer ondersteund, maar u kunt deze nog steeds gebruiken om demo-omgevingen te maken. Er is momenteel geen vervanging en de functies of beschikbaarheid ervan kunnen vanzelf veranderen.

  1. Haal het ADOGenerator-project op in Visual Studio of de IDE van uw keuze en voer het uit.

  2. Wanneer u wordt gevraagd om het sjabloonnummer in de lijst met sjablonen in te voeren, voert u 23 in voor het implementeren van een codewerkstroom in uw build-pijplijn met behulp van Git en GitHub en drukt u op Enter.

  3. Kies uw verificatiemethode. U kunt een persoonlijk toegangstoken (PAT) instellen en gebruiken of apparaataanmelding gebruiken.

    Notitie

    Als u een PAT instelt, moet u de benodigde bereiken autoriseren. Voor deze module kunt u volledige toegang gebruiken, maar in een praktijksituatie moet u ervoor zorgen dat u alleen de benodigde bereiken verleent.

  4. Voer de naam van uw Azure DevOps-organisatie in en druk op Enter.

  5. Als u hierom wordt gevraagd, voert u uw Azure DevOps PAT in en drukt u op Enter.

  6. Voer een projectnaam in, zoals Space Game - web - Workflow, en druk vervolgens op Enter.

  7. Zodra uw project is gemaakt, gaat u naar uw Azure DevOps-organisatie in uw browser (op https://dev.azure.com/<your-organization-name>/) en selecteert u het project.

Belangrijk

De pagina De Azure DevOps-omgeving opschonen in deze module bevat belangrijke opschoonstappen. Door op te schonen bent u ervan verzekerd dat u voldoende gratis buildminuten overhoudt. Voer de opschoonstappen ook uit als u deze module niet voltooit.

De opslagplaats splitsen

Als u dat nog niet hebt gedaan, forkt u de repository mslearn-tailspin-spacegame-web.

  1. Ga op GitHub naar de opslagplaats mslearn-tailspin-spacegame-web .

  2. Selecteer Fork in de rechterbovenhoek van het scherm.

  3. Kies uw GitHub-account als eigenaar en selecteer vervolgens Fork maken.

De zichtbaarheid van uw project instellen

In eerste instantie is uw fork van de Space Game-opslagplaats op GitHub ingesteld op openbaar terwijl het project dat is gemaakt door de Azure DevOps-sjabloon is ingesteld op privé. Een openbare opslagplaats op GitHub is toegankelijk voor iedereen, terwijl een privéopslagplaats alleen toegankelijk is voor u en de personen met wie u deze wilt delen. Op dezelfde manier bieden openbare projecten in Azure DevOps alleen-lezentoegang tot niet-geverifieerde gebruikers, terwijl voor privéprojecten gebruikers toegang moeten worden verleend en geverifieerd voor toegang tot de services.

Op dit moment is het niet nodig om deze instellingen te wijzigen voor de doeleinden van deze module. Voor uw persoonlijke projecten moet u echter bepalen welke zichtbaarheid en toegang u aan anderen wilt verlenen. Als uw project bijvoorbeeld open source is, kunt u ervoor kiezen om zowel uw GitHub-opslagplaats als uw Azure DevOps-project openbaar te maken. Als uw project eigendom is, maakt u doorgaans zowel uw GitHub-opslagplaats als uw Azure DevOps-project privé.

Later kunt u de volgende resources nuttig vinden om te bepalen welke optie het beste is voor uw project:

Verplaats het werkitem naar 'In uitvoering'

In deze sectie wijst u uzelf een werkitem toe dat betrekking heeft op deze module op Azure Boards. Ook verplaatst u het werkitem naar de status In uitvoering. In de praktijk maken u en uw team werkitems aan het begin van elke sprint of iteratie.

Door werk op deze manier toe te wijzen, krijgt u een controlelijst van waaruit u kunt werken. Daarmee hebben anderen in uw team inzicht in waaraan u werkt en hoeveel er nog moet worden gedaan. Het helpt het team ook om wip-limieten (werk in proces) af te dwingen, zodat het team niet te veel werk tegelijk aanneemt.

Zoals u weet, heeft het team deze zeven belangrijkste problemen opgelost:

Een schermopname van Azure Boards met een backlog van problemen.

Notitie

Binnen een Azure DevOps-organisatie worden werkitems opeenvolgend genummerd. In uw project komt het nummer dat aan elk werkitem is toegewezen mogelijk niet overeen met wat u hier ziet.

Hier verplaatst u het tweede item, een op Git gebaseerde werkstroom maken, naar de kolom Uitvoeren en wijst u uzelf toe aan het werkitem.

U herinnert zich misschien dat Een Git-werkstroom maken verband houdt met het overschakelen naar een codewerkstroom die een betere samenwerking tussen teamleden mogelijk maakt.

Een schermopname van Azure Boards met werkitemdetails voor het probleem met een Git-werkstroom maken.

U stelt het werkitem als volgt in:

  1. In Azure DevOps selecteer Borden in het linkerdeelvenster en selecteer vervolgens Borden.

    Een schermopname van Azure DevOps met de locatie van het menu Borden.

  2. In het werkitem 'Een op Git gebaseerde workflow maken', selecteer de Te doen-pijl naar beneden en ken vervolgens het werkitem aan uzelf toe.

    Een schermopname van Azure Boards met de locatie van de pijl-omlaag.

  3. Sleep het werkitem van de kolom Taken naar de kolom Uitvoeren .

    Een schermopname van Azure Boards met het werkitem in de kolom Uitvoeren.

Aan het einde van deze module, nadat u de taak hebt voltooid, verplaatst u het item naar de kolom Gereed .

Het project lokaal instellen

Hier laadt u het Space Game-project in Visual Studio Code, configureert u Git, kloont u uw opslagplaats lokaal en stelt u de upstream remote in, zodat u de starterscode kunt downloaden.

Notitie

Als u het project mslearn-tailspin-spacegame-web al lokaal heeft opgezet, kunt u naar de volgende sectie gaan.

De geïntegreerde terminal openen

Visual Studio Code wordt geleverd met een geïntegreerde terminal, zodat u bestanden kunt bewerken en vanaf de opdrachtregel op één plaats kunt werken.

  1. Visual Studio Code starten.

  2. Selecteer Terminal in het menu Beeld.

  3. Selecteer bash in de vervolgkeuzelijst. Als u bekend bent met een andere Unix-shell die u liever gebruikt, zoals Zsh, selecteert u die shell.

    Een schermopname van Visual Studio Code met de locatie van de Bash-shell.

    In het terminalvenster kunt u elke shell kiezen die op uw systeem is geïnstalleerd, zoals Bash, Zsh en PowerShell.

    Hier gebruikt u Bash. Git voor Windows biedt Git Bash, waarmee u eenvoudig Git-opdrachten kunt uitvoeren.

    Notitie

    Als in Windows Git Bash niet wordt weergegeven als optie, controleert u of u Git hebt geïnstalleerd en start u Visual Studio Code opnieuw.

  4. Voer de cd opdracht uit om naar de map te navigeren waaruit u wilt werken, zoals uw basismap (~). U kunt desgewenst een andere map kiezen.

    cd ~

Git configureren

Als u niet eerder met Git en GitHub werkt, moet u eerst een paar opdrachten uitvoeren om uw identiteit te koppelen aan Git en te verifiëren met GitHub.

Git instellen legt het proces uitgebreider uit.

U moet minimaal de volgende stappen uitvoeren. Voer deze opdrachten uit vanuit de geïntegreerde terminal:

  1. Stel uw gebruikersnaam in.
  2. Stel uw e-mailadres voor doorvoeren in.
  3. Sla uw GitHub-wachtwoord in de cache op.

Notitie

Als u al tweeledige verificatie gebruikt met GitHub, maakt u een persoonlijk toegangstoken en gebruikt u uw token in plaats van uw wachtwoord wanneer u hier later om wordt gevraagd.

Behandel het toegangstoken zoals u een wachtwoord zou behandelen. Bewaar het op een veilige plek.

Stel uw project in Visual Studio Code in

In dit deel kloont u uw fork lokaal, zodat u wijzigingen kunt aanbrengen en de pijplijnconfiguratie kunt uitbouwen.

Notitie

Als u fouten ontvangt over bestandsnamen die te lang zijn wanneer u de opslagplaats kloont, kunt u proberen de opslagplaats te klonen in een map die geen lange naam heeft of diep is genest.

Uw fork lokaal klonen

U hebt nu een kopie van het Space Game-webproject in uw GitHub-account. Nu downloadt of kloont u een kopie naar uw computer, zodat u ermee kunt werken.

Een kloon, net als een fork, is een kopie van een opslagplaats. Wanneer u een opslagplaats kloont, kunt u wijzigingen aanbrengen, controleren of ze naar verwachting werken en deze wijzigingen vervolgens weer uploaden naar GitHub. U kunt uw lokale kopie ook synchroniseren met wijzigingen die andere geverifieerde gebruikers hebben aangebracht in de kopie van uw opslagplaats van GitHub.

Ga als volgende te werk om het Space Game-webproject naar uw computer te klonen:

  1. Ga naar uw fork van het Space Game-webproject (mslearn-tailspin-spacegame-web) op GitHub.

  2. Selecteer Code. Selecteer vervolgens op het tabblad HTTPS de knop naast de URL die wordt weergegeven om de URL naar het klembord te kopiëren.

    De URL zoeken en de knop kopiëren vanuit de GitHub-opslagplaats.

  3. Ga in Visual Studio Code naar het terminalvenster.

  4. Ga in de terminal naar de map waaruit u wilt werken, zoals uw basismap (~). U kunt desgewenst een andere map kiezen.

    cd ~

  5. Voer de opdracht git clone uit. Vervang de URL die hier wordt weergegeven door de inhoud van het Klembord:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git

  6. Naar de mslearn-tailspin-spacegame-web map gaan. Dit is de hoofdmap van uw opslagplaats.

    cd mslearn-tailspin-spacegame-web

Upstream remote instellen

Een externe is een Git-opslagplaats waar teamleden samenwerken (zoals een opslagplaats op GitHub). Hier geeft u uw externe repositories weer en voegt u er een toe die verwijst naar Microsoft's versie van de opslagplaats, zodat u de meest recente codevoorbeelden kunt ophalen.

  1. Voer deze git remote opdracht uit om uw externe apparaten weer te geven:

    git remote -v

    U ziet dat u zowel fetch- (download) als push- (upload) toegang hebt tot uw repository.

    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)

    Origin geeft uw opslagplaats op GitHub aan. Wanneer u code van een andere opslagplaats forkt, is het gebruikelijk om de oorspronkelijke remote (degene waarvan u hebt geforkt) als upstream te noemen.

  2. Voer deze git remote add opdracht uit om een externe upstream te maken die verwijst naar de Microsoft-opslagplaats:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git

  3. Voer git remote een tweede keer uit om de wijzigingen te bekijken:

    git remote -v

    U ziet dat u nog steeds toegang hebt tot zowel ophalen (downloaden) als pushen (uploaden) tot uw opslagplaats. U hebt nu ook haal- en pushtoegang tot de Microsoft-repository.

    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)

Open het project in de verkenner

In Visual Studio Code wijst het terminalvenster naar de hoofdmap van het Space Game-webproject. Als u de structuur wilt bekijken en met bestanden wilt werken, opent u het project vanuit de Verkenner.

  1. De eenvoudigste manier om het project te openen, is door Visual Studio Code opnieuw te openen in de huidige map. Voer hiervoor de volgende opdracht uit vanuit de geïntegreerde terminal:

    code -r .

    U ziet de map en de bestandsstructuur in de verkenner.

  2. Open de geïntegreerde terminal opnieuw. De terminal plaatst u in de hoofddirectorie van uw webproject.

Als het code commando mislukt, moet u Visual Studio Code toevoegen aan uw system path. Hiervoor doet u het volgende:

  1. Selecteer in Visual Studio Code F1 of selecteer Weergave>Opdrachtpalet om het opdrachtenpalet te openen.
  2. Voer in het opdrachtpalet Shell-opdracht in : installeer de opdracht 'code' in PATH.
  3. Herhaal de vorige procedure om het project te openen in de verkenner.

U bent nu ingesteld om te werken met de broncode van Space Game en uw Azure Pipelines-configuratie vanuit uw lokale ontwikkelomgeving.