Ćwiczenie — konfigurowanie środowiska usługi Azure DevOps

Ukończone

W tej lekcji upewnisz się, że organizacja usługi Microsoft Azure DevOps została skonfigurowana do ukończenia pozostałej części tego modułu.

W tym celu wykonasz następujące czynności:

  • Skonfiguruj projekt usługi Azure DevOps dla tego modułu.
  • Upewnij się, że projekt został skonfigurowany lokalnie, aby można było wypchnąć zmiany do potoku.

Pobieranie projektu usługi Azure DevOps

W tym miejscu upewnisz się, że organizacja usługi Azure DevOps została skonfigurowana w celu ukończenia pozostałej części tego modułu, uruchamiając szablon, który tworzy projekt dla Ciebie w usłudze Azure DevOps.

Moduły tej ścieżki szkoleniowej są ze sobą powiązane, dzięki czemu stopniowo śledzimy postępy członków internetowego zespołu Tailspin w ich podróży po metodyce DevOps. Dla celów szkoleniowych każdy moduł ma skojarzony projekt usługi Azure DevOps.

Uruchamianie szablonu

Uruchom szablon, który skonfiguruje wszystkie elementy Twojej organizacji usługi Azure DevOps.

Aby uruchomić szablon, wykonaj następujące czynności w witrynie generatora demonstracyjnego usługi Azure DevOps:

  1. Wybierz pozycję Zaloguj się i zaakceptuj warunki użytkowania.

  2. Na stronie Tworzenie nowego projektu wybierz organizację usługi Azure DevOps, a następnie wprowadź nazwę projektu, na przykład Space Game — web - Agent.

  3. Wybierz pozycję Repozytorium rozwidlenia w witrynie GitHub, a następnie wybierz pozycję Autoryzuj. Jeśli zostanie wyświetlone okno, autoryzuj dostęp do swojego konta usługi GitHub.

    Ważne

    Należy wybrać tę opcję dla szablonu, aby nawiązać połączenie z repozytorium GitHub. Wybierz go, nawet jeśli projekt witryny Space Game został już rozwidlony. Szablon używa istniejącego rozwidlenia.

  4. Wybierz pozycję Utwórz projekt.

    A screenshot of the Azure DevOps Demo Generator Create New Project screen with the Create Project button highlighted.

    Uruchomienie szablonu może potrwać kilka chwil.

  5. Wybierz pozycję Przejdź do projektu , aby przejść do projektu w usłudze Azure DevOps.

Ważne

Na stronie Czyszczenie środowiska usługi Azure DevOps w tym module znajdują się ważne kroki czyszczenia. Czyszczenie pomaga oszczędzać bezpłatne minuty przeznaczone na kompilację. Pamiętaj, aby wykonać kroki czyszczenia, nawet jeśli nie ukończono tego modułu.

Konfigurowanie projektu lokalnie

W tym miejscu załadujesz projekt Space Game w programie Visual Studio Code, skonfigurujesz usługę Git, sklonujesz repozytorium lokalnie i skonfigurujesz zdalny nadrzędny kod, aby można było pobrać kod startowy.

Uwaga

Jeśli masz już skonfigurowany projekt mslearn-tailspin-spacegame-web lokalnie, możesz przejść do następnej sekcji.

Otwieranie zintegrowanego terminalu

Program Visual Studio Code jest dostarczany ze zintegrowanym terminalem, dzięki czemu można edytować pliki i pracować z poziomu wiersza polecenia w jednym miejscu.

  1. Uruchom program Visual Studio Code.

  2. W menu Widok wybierz pozycję Terminal.

  3. Z listy rozwijanej wybierz pozycję bash. Jeśli znasz inną powłokę systemu Unix, której chcesz użyć, na przykład Zsh, wybierz tę powłokę.

    A screenshot of Visual Studio Code showing the location of the Bash shell.

    Okno terminalu umożliwia wybranie dowolnej powłoki zainstalowanej w systemie, takiej jak Bash, Zsh i PowerShell.

    W tym miejscu użyjesz powłoki Bash. Usługa Git dla systemu Windows udostępnia powłokę Git Bash, która ułatwia uruchamianie poleceń git.

    Uwaga

    Jeśli w systemie Windows nie widzisz powłoki Git Bash jako opcji, upewnij się, że zainstalowano narzędzie Git, a następnie uruchom ponownie program Visual Studio Code.

  4. Uruchom polecenie , cd aby przejść do katalogu, z którego chcesz pracować, na przykład do katalogu macierzystego (~). Jeśli chcesz, możesz wybrać inny katalog.

    cd ~
    

Konfigurowanie usługi Git

Jeśli dopiero zaczynasz korzystać z usług Git i GitHub, najpierw musisz uruchomić kilka poleceń, aby skojarzyć swoją tożsamość z usługą Git i uwierzytelnić się w usłudze GitHub.

Konfigurowanie usługi Git wyjaśnia proces bardziej szczegółowo.

Co najmniej należy wykonać poniższe kroki. Uruchom następujące polecenia ze zintegrowanego terminalu:

  1. Ustaw nazwę użytkownika.
  2. Ustaw adres e-mail zatwierdzenia.
  3. Buforuj hasło usługi GitHub.

Uwaga

Jeśli już używasz uwierzytelniania dwuskładnikowego w usłudze GitHub, utwórz osobisty token dostępu i użyj tokenu zamiast hasła po wyświetleniu monitu później.

Traktuj token dostępu tak, jakby hasło. Zachowaj je w bezpiecznym miejscu.

Konfigurowanie projektu w programie Visual Studio Code

W tej części sklonujesz rozwidlenie lokalne, aby można było wprowadzić zmiany i skompilować konfigurację potoku.

Klonowanie rozwidlenia lokalnie

Masz teraz kopię projektu internetowego Space Game na swoim koncie usługi GitHub. Teraz pobierzesz lub sklonujesz kopię na komputer, aby móc z nim pracować.

Klon, podobnie jak rozwidlenie, jest kopią repozytorium. Podczas klonowania repozytorium możesz wprowadzić zmiany, sprawdzić, czy działają zgodnie z oczekiwaniami, a następnie przekazać te zmiany z powrotem do usługi GitHub. Możesz również zsynchronizować kopię lokalną ze zmianami wprowadzonych przez innych uwierzytelnionych użytkowników do kopii repozytorium GitHub.

Aby sklonować projekt internetowy Space Game na komputer:

  1. Przejdź do rozwidlenia projektu internetowego Space Game (mslearn-tailspin-spacegame-web) w witrynie GitHub.

  2. Wybierz pozycję Kod. Następnie na karcie HTTPS wybierz przycisk obok wyświetlanego adresu URL, aby skopiować adres URL do schowka.

    Locating the URL and copy button from the GitHub repository.

  3. W programie Visual Studio Code przejdź do okna terminalu.

  4. W terminalu przejdź do katalogu, z którego chcesz pracować, na przykład do katalogu macierzystego (~). Jeśli chcesz, możesz wybrać inny katalog.

    cd ~
    
  5. Uruchom polecenie git clone. Zastąp adres URL widoczny tutaj zawartością schowka:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
    
  6. Przejdź do mslearn-tailspin-spacegame-web katalogu. Jest to katalog główny Twojego repozytorium.

    cd mslearn-tailspin-spacegame-web
    

Konfigurowanie nadrzędnego połączenia zdalnego

Zdalne to repozytorium Git, w którym członkowie zespołu współpracują (na przykład repozytorium w usłudze GitHub). W tym miejscu możesz wyświetlić listę zdalnych i dodać zdalny, który wskazuje kopię repozytorium firmy Microsoft, aby uzyskać najnowszy przykładowy kod.

  1. Uruchom to git remote polecenie, aby wyświetlić listę zdalnych:

    git remote -v
    

    Zobaczysz, że masz dostęp zarówno do pobierania (pobierania), jak i wypychania (przekazywania) do repozytorium:

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

    Źródło określa repozytorium w usłudze GitHub. Podczas tworzenia rozwidlenia kodu z innego repozytorium jest to wspólne nazwanie oryginalnego zdalnego (rozwidlenia) jako nadrzędnego.

  2. Uruchom to git remote add polecenie, aby utworzyć zdalny nazwany nadrzędny, który wskazuje repozytorium firmy Microsoft:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
    
  3. Uruchom git remote drugi raz, aby zobaczyć zmiany:

    git remote -v
    

    Zobaczysz, że nadal masz dostęp do pobierania (pobierania) i wypychania (przekazywania) do repozytorium. Teraz masz również dostęp do pobierania i wypychania do repozytorium firmy Microsoft:

    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)
    

Otwieranie projektu w Eksploratorze plików

W programie Visual Studio Code okno terminala wskazuje katalog główny projektu witryny gry Space Game. Aby wyświetlić jego strukturę i pracować z plikami, w Eksploratorze plików zostanie otwarty projekt.

  1. Najprostszym sposobem otwarcia projektu jest ponowne otwarcie programu Visual Studio Code w bieżącym katalogu. W tym celu uruchom następujące polecenie w zintegrowanym terminalu:

    code -r .
    

    Katalog i drzewo plików zostaną wyświetlone w eksploratorze plików.

  2. Otwórz ponownie zintegrowany terminal. Terminal umieszcza Cię w katalogu głównym projektu internetowego.

Jeśli polecenie zakończy się niepowodzeniem code , musisz dodać program Visual Studio Code do ścieżki systemowej. Aby to zrobić:

  1. W programie Visual Studio Code wybierz pozycję F1 lub wybierz pozycję Wyświetl>paletę poleceń, aby uzyskać dostęp do palety poleceń.
  2. W palecie poleceń wprowadź polecenie Powłoka: Zainstaluj polecenie "code" w ścieżce PATH.
  3. Powtórz poprzednią procedurę, aby otworzyć projekt w Eksploratorze plików.

Teraz skonfigurujesz pracę z kodem źródłowym Space Game i konfiguracją usługi Azure Pipelines z lokalnego środowiska deweloperskiego.