Ćwiczenie — konfigurowanie środowiska
Zespół powoli integruje strategię DevOps ze swoimi procesami. W tej sekcji upewnij się, że środowisko odzwierciedla wysiłki zespołu do tej pory.
W tym celu wykonasz następujące czynności:
- Dodaj użytkownika, aby upewnić się, że usługa Azure DevOps może łączyć się z subskrypcją platformy Azure.
- Skonfiguruj projekt usługi Azure DevOps dla tego modułu.
- Dodaj potok kompilacji.
Dodawanie użytkownika do usługi Azure DevOps
Do ukończenia tego modułu potrzebna jest własna subskrypcja platformy Azure. Możesz bezpłatnie rozpocząć pracę z platformą Azure.
Chociaż nie potrzebujesz subskrypcji, aby korzystać z usługi Azure DevOps do jej działania, w tym miejscu użyjesz usługi Azure DevOps do wdrożenia w zasobach platformy Azure, które istnieją w ramach subskrypcji platformy Azure. Aby uprościć ten proces, zaloguj się zarówno do subskrypcji platformy Azure, jak i organizacji usługi Azure DevOps na tym samym koncie Microsoft.
Jeśli używasz różnych kont Microsoft do logowania się do platformy Azure i usługi Azure DevOps, dodaj użytkownika do organizacji DevOps w ramach konta Microsoft używanego do logowania się na platformie Azure. Aby uzyskać więcej informacji, zobacz Dodawanie użytkowników organizacji i zarządzanie dostępem. Po dodaniu użytkownika wybierz poziom dostępu Podstawowy .
Następnie wyloguj się z usługi Azure DevOps i zaloguj się ponownie na koncie Microsoft używanym do logowania się do subskrypcji platformy Azure.
Pobieranie projektu usługi Azure DevOps
Upewnij się, że organizacja usługi Azure DevOps została skonfigurowana w celu ukończenia pozostałej części tego modułu. W tym celu uruchomisz szablon, który tworzy projekt dla Ciebie w usłudze Azure DevOps.
Moduły w tej ścieżce szkoleniowej tworzą postęp w miarę obserwowania zespołu internetowego Tailspin za pośrednictwem ich podróży 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.
W witrynie Azure DevOps Demo Generator wykonaj następujące kroki, aby uruchomić szablon:
Wybierz pozycję Zaloguj się i zaakceptuj warunki użytkowania.
Na stronie Tworzenie nowego projektu wybierz organizację usługi Azure DevOps i wprowadź nazwę projektu, taką jak Space Game — web - Release.
Wybierz pozycję Tak. Chcę utworzyć rozwidlenie tego repozytorium>Autoryzuj. Jeśli zostanie wyświetlone okno, autoryzuj dostęp do swojego konta usługi GitHub.
Ważne
Musisz wybrać tę opcję, aby szablon łączył się z repozytorium GitHub. Wybierz go, nawet jeśli projekt witryny Space Game został już rozwidlony. Szablon używa istniejącego rozwidlenia.
Wybierz pozycję Utwórz projekt. Uruchomienie szablonu zajmuje kilka chwil.
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.
Ustawianie widoczności projektu
Początkowo rozwidlenie repozytorium Space Game w usłudze GitHub jest ustawione na publiczne, podczas gdy projekt utworzony przez szablon usługi Azure DevOps jest ustawiony na prywatny. Do repozytorium publicznego w usłudze GitHub można uzyskać dostęp dowolnej osobie, natomiast prywatne repozytorium jest dostępne tylko dla Ciebie i osób, którym chcesz je udostępnić. Podobnie w usłudze Azure DevOps publiczne projekty zapewniają dostęp tylko do odczytu użytkownikom nieuwierzytelnionemu, podczas gdy projekty prywatne wymagają od użytkowników udzielenia dostępu i uwierzytelnienia w celu uzyskania dostępu do usług.
W tej chwili nie jest konieczne zmodyfikowanie żadnego z tych ustawień na potrzeby tego modułu. Jednak w przypadku projektów osobistych musisz określić widoczność i dostęp, który chcesz udzielić innym osobom. Jeśli na przykład projekt jest projektem typu open source, możesz zdecydować się na upublicznienie zarówno repozytorium GitHub, jak i projektu usługi Azure DevOps. Jeśli projekt jest zastrzeżony, zazwyczaj zarówno repozytorium GitHub, jak i projekt usługi Azure DevOps są prywatne.
W dalszej części możesz znaleźć następujące zasoby pomocne podczas określania, która opcja jest najlepsza dla projektu:
- Korzystanie z projektów prywatnych i publicznych
- Szybki start: publiczne ustawianie prywatnego projektu
- Setting repository visibility (Ustawianie widoczności repozytorium)
Przygotowywanie programu Visual Studio Code
Skonfiguruj program Visual Studio Code, aby można było lokalnie skompilować witrynę internetową i użyć plików źródłowych.
Program Visual Studio Code jest dostarczany ze zintegrowanym terminalem, dzięki czemu można edytować pliki i pracować z poziomu wiersza polecenia— wszystko z jednego miejsca.
Uruchom program Visual Studio Code.
Wybierz pozycję Terminal, a następnie wybierz pozycję Nowy terminal.
Z listy rozwijanej wybierz pozycję Git bash. Jeśli znasz inną powłokę systemu Unix, której chcesz użyć, na przykład Zsh, wybierz tę powłokę. 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.
Uruchom następujące polecenie, aby przejść do katalogu macierzystego.
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. Aby uzyskać więcej informacji, zobacz Konfigurowanie usługi Git.
Co najmniej należy wykonać następujące czynności:
- Pobierz i zainstaluj najnowszą wersję narzędzia Git.
- Ustaw nazwę użytkownika.
- Ustaw adres e-mail zatwierdzenia.
Uwaga
Jeśli już używasz uwierzytelniania dwuskładnikowego w usłudze GitHub, utwórz osobisty token dostępu. Użyj tokenu zamiast hasła po wyświetleniu monitu później.
Traktuj token dostępu tak, jak chcesz traktować hasło. Zachowaj je w bezpiecznym miejscu.
Konfigurowanie projektu w programie Visual Studio Code
Po uruchomieniu szablonu w celu skonfigurowania projektu usługi Azure DevOps proces automatycznie utworzył rozwidlenie repozytorium mslearn-tailspin-spacegame-web-deploy . Teraz pobierzesz lub sklonujesz kopię na komputer, aby móc z nim pracować.
Klonowanie rozwidlenia lokalnie
W witrynie GitHub przejdź do rozwidlenia projektu internetowego Space Game (mslearn-tailspin-spacegame-web-deploy).
Wybierz pozycję Kod, a następnie na karcie HTTPS wybierz przycisk kopiowania, aby skopiować adres URL do schowka.
W programie Visual Studio Code przejdź do otwartego wcześniej okna terminalu.
Uruchom polecenie
git clone
. Zastąp adres URL widoczny tutaj zawartością schowka:git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git
Przejdź do katalogu mslearn-tailspin-spacegame-web-deploy . Ten katalog jest katalogiem głównym repozytorium.
cd mslearn-tailspin-spacegame-web-deploy
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.
Uruchom następujące 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-deploy.git (fetch) origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
Źródło określa repozytorium w usłudze GitHub. W przypadku rozwidlenia kodu z innego repozytorium oryginalny zdalny (rozwidlenie z) jest często określany jako nadrzędny.
Uruchom następujące 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-deploy.git
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 pobrania z repozytorium firmy Microsoft:
origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch) origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push) upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch) upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (push)
Otwieranie projektu w programie Visual Studio Code
Uruchom następujące polecenie z katalogu głównego projektu.
code .
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ć:
- W programie Visual Studio Code wybierz pozycję F1 lub wybierz pozycję Wyświetl>paletę poleceń, aby uzyskać dostęp do palety poleceń.
- Wpisz polecenie powłoki i znajdź polecenie powłoki: zainstaluj polecenie "code" w poleceniu PATH .
- Uruchom ponownie terminal, aby nowy element PATH został zastosowany.
Teraz skonfigurujesz pracę z kodem źródłowym Space Game i konfiguracją usługi Azure Pipelines z lokalnego środowiska deweloperskiego.
Pobieranie gałęzi z repozytorium GitHub
W programie Visual Studio Code otwórz zintegrowany terminal.
Uruchom następujące polecenia, aby pobrać gałąź release-pipeline z repozytorium MicrosoftDocs i wyewidencjonować nową gałąź nadrzędną/potok wydania.
git fetch upstream release-pipeline git checkout -B release-pipeline upstream/release-pipeline
Opcjonalnie w programie Visual Studio Code otwórz plik azure-pipelines.yml i zapoznaj się z początkową konfiguracją potoku YAML.
Uruchamianie potoku
W tym momencie masz następujące elementy:
- Rozwidlenie repozytorium mslearn-tailspin-spacegame-web-deploy na koncie usługi GitHub.
- Repozytorium mslearn-tailspin-spacegame-web-deploy sklonowane lokalnie.
- Gałąź o nazwie release-pipeline zawierająca kod źródłowy witryny internetowej i początkową konfigurację usługi Azure Pipelines.
Następnie ręcznie wyzwolisz potok do uruchomienia. Ten krok gwarantuje, że projekt zostanie skonfigurowany do kompilowania z repozytorium GitHub. Początkowa konfiguracja potoku kompiluje aplikację i tworzy artefakt kompilacji.
Przejdź do projektu w usłudze Azure Devops, a następnie wybierz pozycję Potoki.
Wybierz potok mslearn-tailspin-spacegame-web-deploy. Jeśli zostanie wyświetlony monit, upewnij się, że wybrano pozycję Autoryzuj zasoby , aby autoryzować połączenie z usługą.
Wybierz pozycję Uruchom potok, a następnie wybierz gałąź potoku wydania z menu rozwijanego Gałąź/tag . Wybierz Uruchom.
Na stronie Podsumowanie wybierz zadanie potoku, aby wyświetlić dzienniki.
Po zakończeniu kompilacji wybierz przycisk Wstecz, aby powrócić do strony podsumowania.
Wybierz opublikowany artefakt.
Tailspin.Space.Game.Web.zip to artefakt kompilacji. Ten plik zawiera skompilowana aplikację i jej zależności.
Masz teraz potok kompilacji dla projektu internetowego Space Game. Następnie dodasz etap wdrażania, aby wdrożyć artefakt kompilacji w usłudze aplikacja systemu Azure Service.