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

Een sjabloon uitvoeren waarmee alles in uw Azure DevOps-organisatie voor u wordt ingesteld.

De sjabloon uitvoeren

Ga als volgt te werk om de sjabloon uit te voeren op de azure DevOps Demo Generator-site:

  1. Selecteer Aanmelden en accepteer de gebruiksvoorwaarden.

  2. Selecteer uw Azure DevOps-organisatie op de pagina Nieuw project maken en voer vervolgens een projectnaam in, zoals Space Game - web - Workflow.

  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 zelfs als u het Space Game-websiteproject al hebt gesplitst. De sjabloon maakt gebruik van de bestaande fork.

  4. Selecteer Project maken.

    A screenshot of the Azure DevOps Demo Generator showing how to create a new project.

    Het duurt even voordat de sjabloon is uitgevoerd.

  5. Selecteer Navigeren naar project om naar uw project te gaan in Azure DevOps.

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

A screenshot of Azure Boards showing a backlog of issues.

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.

A screenshot of Azure Boards showing work item details for the Create a Git-based workflow issue.

U stelt het werkitem als volgt in:

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

    A screenshot of Azure DevOps showing the location of the Boards menu.

  2. Selecteer in het werkitem Een op Git gebaseerde werkstroom maken de pijl-omlaag en wijs het werkitem vervolgens aan uzelf toe.

    A screenshot of Azure Boards showing the location of the down arrow.

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

    A screenshot of Azure Boards showing the work item in the Doing column.

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

    A screenshot of Visual Studio Code showing the location of the 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.

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.

    Locating the URL and copy button from the GitHub repository.

  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.