Ćwiczenie — publikowanie repozytorium

5 min

W firmie toy, deweloperzy witryny internetowej zaoferowali ci pomoc w pisaniu szablonu Bicep. Powiedziano ci, że trzymasz kod Bicep w repozytorium i poproszono Cię o opublikowanie repozytorium. W tym ćwiczeniu opublikujesz repozytorium Git, aby umożliwić współpracownikom wyświetlanie plików i współpracę z Tobą.

Podczas tego procesu wykonasz następujące czynności:

Utwórz nowe repozytorium zdalne.
Skonfiguruj lokalne repozytorium Git, aby zintegrować je z repozytorium zdalnym.
Wypchnij zmiany z repozytorium lokalnego do repozytorium zdalnego.
Sprawdź, czy zmiany są wyświetlane w repozytorium zdalnym.

Tworzenie repozytorium w usłudze GitHub

W przeglądarce przejdź do usługi GitHub. Zaloguj się przy użyciu konta usługi GitHub lub utwórz nowe konto, jeśli go nie masz.
Wybierz ikonę plus (+) w prawym górnym rogu okna, a następnie wybierz pozycję Nowe repozytorium.
Wprowadź szczegóły nowego repozytorium:
- Właściciel: wybierz nazwę użytkownika usługi GitHub z menu rozwijanego. Na zrzucie ekranu mygithubuser znajduje się nazwa konta właściciela repozytorium GitHub. W dalszej części tego modułu użyjesz nazwy konta.
- Nazwa repozytorium: wprowadź zrozumiałą, ale krótką nazwę. W tym module użyj polecenia toy-website-workflow.
- Opis: dołącz opis, aby ułatwić innym osobom zrozumienie przeznaczenia repozytorium.
- Prywatny: możesz użyć usługi GitHub do tworzenia repozytoriów publicznych i prywatnych. Utwórz prywatne repozytorium, ponieważ tylko osoby w organizacji powinny uzyskiwać dostęp do plików witryny internetowej. Możesz udzielić dostępu innym osobom później.
Po zakończeniu konfiguracja repozytorium powinna wyglądać podobnie jak na poniższym zrzucie ekranu:
Kliknij przycisk Create repository (Utwórz repozytorium).
Na wyświetlonej stronie potwierdzenia zanotuj adres URL repozytorium. Możesz użyć przycisku kopiowania, aby skopiować adres URL. Wkrótce go użyjesz.

Tworzenie repozytorium w Azure Repos

W przeglądarce przejdź do usługi Azure DevOps. Zaloguj się lub utwórz nowe konto.
Jeśli tworzysz nowe konto, postępuj zgodnie z monitami, aby utworzyć organizację usługi Azure DevOps. Usługa Azure DevOps następnie prosi o utworzenie nowego projektu. Przejdź do następnego kroku.

Jeśli zalogowałeś się do istniejącej organizacji usługi Azure DevOps, wybierz przycisk Nowy projekt , aby utworzyć nowy projekt.
Wprowadź szczegóły nowego projektu:
- Nazwa projektu: wprowadź zrozumiałą, ale krótką nazwę. W tym module użyj polecenia toy-website.
- Opis: dołącz opis, aby ułatwić innym osobom zrozumienie przeznaczenia repozytorium.
- Widoczność: możesz użyć usługi Azure DevOps do tworzenia repozytoriów publicznych i prywatnych. Utwórz prywatne repozytorium, ponieważ tylko osoby w organizacji powinny uzyskiwać dostęp do plików witryny internetowej. Możesz udzielić dostępu innym osobom później.
Po zakończeniu konfiguracja projektu powinna wyglądać podobnie jak na poniższym zrzucie ekranu:
Wybierz przycisk Utwórz.
Na wyświetlonej stronie projektu wybierz element menu Repozytoria .
Zanotuj adres URL repozytorium. Możesz użyć przycisku kopiowania, aby skopiować adres URL. Wkrótce go użyjesz.

Generowanie hasła usługi Git

Podczas pracy z Azure Repos z Visual Studio Code w systemie macOS należy użyć specjalnego hasła, które różni się od hasła używanego do logowania.

Uwaga

Jeśli używasz systemu Windows, przejdź do następnej sekcji Konfigurowanie lokalnego repozytorium Git.

Wybierz przycisk Generuj poświadczenia usługi Git .

Azure Repos tworzy losowe hasło do użycia.
Zanotuj wartość Hasło . Wkrótce go użyjesz.

Pozostaw otwartą przeglądarkę. W dalszej części tego ćwiczenia sprawdzisz repozytorium.

Konfigurowanie lokalnego repozytorium Git

Upewnij się, że jesteś w gałęzi głównej, wprowadzając następujące polecenie w terminalu Visual Studio Code:
```
git checkout main
```
Wprowadź następujące polecenie, aby zintegrować lokalne repozytorium z utworzonym repozytorium zdalnym. Zastąp YOUR_REPOSITORY_URL ciąg adresem URL zapisanym wcześniej.
```
git remote add origin YOUR_REPOSITORY_URL
```
Zwróć uwagę, że używasz polecenia git remote add , aby utworzyć nowe odwołanie do repozytorium zdalnego. Nazwa odwołania originto nazwa standardowa.

Sprawdź, czy zostało utworzone zdalne.

git remote -v

Dane wyjściowe będą wyglądać podobnie do przykładu.

origin  https://github.com/mygithubuser/toy-website.git (fetch)
origin  https://github.com/mygithubuser/toy-website.git (push)

origin https://myuser@dev.azure.com/myuser/toy-website/_git/toy-website (fetch)
origin https://myuser@dev.azure.com/myuser/toy-website/_git/toy-website (push)

Wypychanie zmian przy użyciu interfejsu wiersza polecenia usługi Git

W terminalu Visual Studio Code wprowadź następujące polecenie:
```
git push -u origin main
```
Ponieważ bieżąca gałąź lokalna jest główną, to polecenie informuje usługę Git, że lokalna gałąź głównaśledzi gałąź główną w repozytorium zdalnym. Wypycha również zatwierdzenia z repozytorium lokalnego do repozytorium zdalnego.
Po raz pierwszy użyto tego repozytorium zdalnego, dlatego w terminalu zostanie wyświetlony monit o wybranie sposobu uwierzytelniania. Wybierz opcję, aby użyć przeglądarki.
Postępuj zgodnie z instrukcjami w przeglądarce, aby zalogować się i autoryzować Visual Studio Code w celu uzyskania dostępu do repozytorium GitHub.

W oknie terminalu usługa Git wyświetla dane wyjściowe podobne do następującego przykładu:

Enumerating objects: 16, done.
Counting objects: 100% (16/16), done.
Delta compression using up to 8 threads
Compressing objects: 100% (11/11), done.
Writing objects: 100% (16/16), 2.30 KiB | 785.00 KiB/s, done.
Total 16 (delta 2), reused 0 (delta 0), pack-reused 0
remote: Resolving deltas: 100% (2/2), done.
To https://github.com/mygithubuser/toy-website.git
 * [new branch]      main -> main
Branch 'main' set up to track remote branch 'main' from 'origin'.

Te dane wyjściowe wskazują, że usługa Git pomyślnie wypchnęła zawartość repozytorium do repozytorium zdalnego.

W terminalu Visual Studio Code wprowadź następujące polecenie:
```
git push -u origin main
```
Ponieważ bieżąca gałąź lokalna jest główną, to polecenie informuje usługę Git, że lokalna gałąź głównaśledzi gałąź główną w repozytorium zdalnym. Wypycha również zatwierdzenia z repozytorium lokalnego do zdalnego.
Po raz pierwszy użyto tego repozytorium, więc zostanie wyświetlony monit o zalogowanie się.

Jeśli używasz systemu Windows, wprowadź te same poświadczenia, które były używane do logowania się do usługi Azure DevOps wcześniej w tym ćwiczeniu.

Jeśli używasz systemu macOS, wklej hasło wygenerowane wcześniej w tym ćwiczeniu.

W oknie terminalu usługa Git wyświetla dane wyjściowe podobne do następującego przykładu:

Enumerating objects: 16, done.
Counting objects: 100% (16/16), done.
Delta compression using up to 8 threads
Compressing objects: 100% (11/11), done.
Writing objects: 100% (16/16), 2.30 KiB | 785.00 KiB/s, done.
Total 16 (delta 2), reused 0 (delta 0), pack-reused 0
remote: Analyzing objects... (16/16) (5 ms)
remote: Storing packfile... done (165 ms)
remote: Storing index... done (75 ms)
To https://dev.azure.com/myuser/toy-website/_git/toy-website
 * [new branch]      main -> main
Branch 'main' set up to track remote branch 'main' from 'origin'.

Te dane wyjściowe wskazują, że usługa Git pomyślnie wypchnęła zawartość repozytorium do repozytorium zdalnego.

Dodawanie pliku README

Teraz, gdy twoi współpracownicy będą używać repozytorium, ważne jest utworzenie pliku README.md , aby pomóc im zrozumieć, co jest twoim repozytorium i jak można rozpocząć pracę.

Otwórz Eksploratora w Visual Studio Code.
Dodaj nowy plik w katalogu głównym bieżącej struktury folderów i nadaj mu nazwę README.md.
Skopiuj następujący tekst do pliku:
```
# Toy company's website

This repository contains the website for our toy company.

## How to use

The Azure infrastructure is defined using [Bicep](https://learn.microsoft.com/azure/azure-resource-manager/bicep).

To deploy the website's Azure resources, use the _deploy/main.bicep_ file.
```
Porada

Jest to plik README symbolu zastępczego, więc nie ma dużo przydatnej zawartości. Podczas pracy z własnymi repozytoriami Git utwórz plik README, który pomoże komuś zrozumieć, jak rozpocząć pracę z kodem. Pomyśl o tym jako o lekkim podręczniku dla projektu.
Zapisz plik.
Przygotuj i zatwierdź plik w lokalnym repozytorium Git. Możesz wybrać, czy zatwierdzasz za pomocą interfejsu wiersza polecenia usługi Git, czy za pomocą kontroli źródła w Visual Studio Code.

Wypychanie ponownie przy użyciu Visual Studio Code

Teraz, po zatwierdzeniu nowego pliku, należy ponownie wypchnąć zmiany, aby zdalny miał najnowsze pliki. Tym razem użyjesz Visual Studio Code do wypchnięcia do repozytorium zdalnego.

Kontrola typu open source w programie Visual Studio Code.
Wybierz ikonę z trzema kropkami po prawej stronie paska narzędzi Kontrola źródła , a następnie wybierz pozycję Wypchnij.

Zwróć uwagę, że nie zostanie wyświetlony monit o ponowne zalogowanie się. Twoje poświadczenia są współużytkowane przez interfejs wiersza polecenia usługi Git i Visual Studio Code.

Weryfikowanie zmian w usłudze GitHub

Po wypchnięciu zmian do repozytorium zdalnego możesz sprawdzić zawartość repozytorium w usłudze GitHub.

W przeglądarce odśwież stronę repozytorium.
Zwróć uwagę, że utworzone pliki są teraz wyświetlane, a plik README.md jest wyświetlany.
Przejrzyj interfejs usługi GitHub, aby zapoznać się z plikami, i zwróć uwagę, że wszystkie zmiany są wyświetlane. Ponieważ usługa GitHub zawiera pełną listę zmian w każdym pliku, możesz nawet wyświetlić historię pliku, tak jak w przypadku pracy w Visual Studio Code.

Weryfikowanie zmian w Azure Repos

Po wypchnięciu zmian do repozytorium zdalnego możesz sprawdzić zawartość repozytorium w Azure Repos.

W przeglądarce odśwież stronę Repozytoria .
Zwróć uwagę, że utworzone pliki są teraz wyświetlane, a plik README.md jest wyświetlany.
Przejrzyj interfejs usługi GitHub, aby zapoznać się z plikami, i zwróć uwagę, że wszystkie zmiany są wyświetlane. Ponieważ usługa GitHub zawiera pełną listę zmian w każdym pliku, możesz nawet wyświetlić historię pliku, tak jak w przypadku pracy w Visual Studio Code.

Kontynuuj