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 op Azure Boards het werkitem voor deze module 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 een project voor u wordt gemaakt 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

Als u alles voor u in uw Azure DevOps-organisatie wilt instellen, voert u een sjabloon uit.

De sjabloon uitvoeren

Voer deze stappen uit vanuit de azure DevOps-demogeneratorsite om de sjabloon uit te voeren.

  1. Selecteer Aanmelden en accepteer de gebruiksvoorwaarden.

  2. Selecteer uw Azure DevOps-organisatie op de pagina Nieuw project maken en voer een projectnaam in. Voer bijvoorbeeld Space Game - web - Afhankelijkheden in.

  3. Selecteer Ja, ik wil deze opslagplaats splitsen en vervolgens Autoriseren selecteren. Als er een venster verschijnt, keurt u toegang tot uw GitHub-account goed.

    Belangrijk

    Selecteer deze optie, zodat de sjabloon verbinding kan maken met de GitHub-opslagplaats. Selecteer deze optie, zelfs als u het Space Game-websiteproject al hebt gesplitst. De sjabloon maakt gebruik van de bestaande fork.

  4. Selecteer Project maken.

    Een schermopname van de Azure DevOps-demogenerator die laat zien hoe u een nieuw project maakt.

    Het duurt even voordat de sjabloon is uitgevoerd.

  5. Als u naar uw project in Azure DevOps wilt gaan, selecteert u Navigeren naar project wanneer het project klaar is met het bouwen.

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 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:

Het werkitem naar In uitvoering verplaatsen

In deze sectie wijst u een werkitem toe aan uzelf 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 werk-in-voortgangslimieten 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 achterstand 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 zesde item, verplaatst u modelgegevens naar een eigen pakket naar de kolom Uitvoeren en wijst u uzelf toe aan het werkitem.

Denk eraan dat Modelgegevens verplaatsen naar een eigen pakket betrekking heeft op het verplaatsen van herbruikbare code naar een eigen NuGet-pakket, zodat het pakket kan worden gedeeld tussen meerdere apps.

Een schermopname van Azure Boards met werkitemgegevens voor de modelgegevens verplaatsen naar een eigen pakketprobleem.

U stelt het werkitem als volgt in:

  1. Ga in Azure DevOps naar Borden en selecteer Borden in het menu.

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

  2. Selecteer in de gegevens van het model verplaatsen naar een eigen pakketwerkitem de pijl-omlaag onder aan de kaart en wijs het werkitem vervolgens aan uzelf toe.

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

  3. Verplaats het werkitem van de kolom Taken naar de kolom In uitvoering.

    Een schermopname van Azure Boards, met de kaart in de kolom Uitvoeren.

Aan het einde van deze module, nadat u de taak hebt voltooid, verplaatst u de kaart 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 al lokaal bent ingesteld met het project mslearn-tailspin-spacegame-web , 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 uw toegangstoken op een wachtwoord. Bewaar het op een veilige plek.

Uw project instellen in Visual Studio Code

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

De upstream remote instellen

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

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

    git remote -v

    U ziet dat u zowel toegang hebt opgehaald (downloaden) als pushen (uploaden) tot uw opslagplaats:

    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 versplitste, is het gebruikelijk om de oorspronkelijke externe naam te geven (degene die u hebt gesplitst) als upstream.

  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 toegang tot de Microsoft-opslagplaats opgehaald en gepusht:

    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 hoofdmap van uw webproject.

Als de code opdracht mislukt, moet u Visual Studio Code toevoegen aan uw systeemPAD. Hiervoor doet u het volgende:

  1. Selecteer in Visual Studio Code F1 of selecteer Opdrachtpalet weergeven>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.