Ćwiczenie — zatwierdzanie plików w repozytorium i wyświetlanie ich historii

Ukończone

W poprzednim ćwiczeniu zainicjowano repozytorium Git dla witryny internetowej swojej firmy. Dodano plik Bicep, ale nie został on zatwierdzony.

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

  • Zatwierdź plik utworzony w poprzednim ćwiczeniu.
  • Dodaj nowy moduł Bicep i porównaj różnice w kodzie Bicep przy użyciu narzędzia Git.
  • Zatwierdź zaktualizowany kod Bicep.
  • Wyświetl historię zatwierdzń i historię głównego pliku Bicep.

Proces wprowadzania większej liczby zmian w kodzie Bicep pokazuje, jak usługa Git i Visual Studio Code ułatwia śledzenie zmian i zarządzanie nimi.

Zatwierdzanie pliku Bicep przy użyciu interfejsu wiersza polecenia usługi Git

  1. Za pomocą terminalu Visual Studio Code uruchom następujące polecenie, aby przygotować plik main.bicep:

    git add deploy/main.bicep
    
  2. Uruchom następujące polecenie, aby zatwierdzić zmiany etapowe i podać komunikat zatwierdzenia:

    git commit --message "Add first version of Bicep template."
    

Dodawanie modułu Bicep

W tym miejscu dodasz moduł Bicep i odwołujesz się do niego z pliku main.bicep .

  1. W folderze deploy utwórz podfolder o nazwie modules.

  2. W folderze modules utwórz nowy plik o nazwie app-service.bicep.

  3. Otwórz i zapisz pusty plik app-service.bicep, aby Visual Studio Code załadować narzędzia Bicep.

  4. Skopiuj następujący kod do pliku app-service.bicep:

    @description('The Azure region into which the resources should be deployed.')
    param location string
    
    @description('The type of environment. This must be nonprod or prod.')
    @allowed([
      'nonprod'
      'prod'
    ])
    param environmentType string
    
    @description('The name of the App Service app. This name must be globally unique.')
    param appServiceAppName string
    
    var appServicePlanName = 'toy-website-plan'
    var appServicePlanSkuName = (environmentType == 'prod') ? 'P2v3' : 'F1'
    var appServicePlanTierName = (environmentType == 'prod') ? 'PremiumV3' : 'Free'
    
    resource appServicePlan 'Microsoft.Web/serverFarms@2020-06-01' = {
      name: appServicePlanName
      location: location
      sku: {
        name: appServicePlanSkuName
        tier: appServicePlanTierName
      }
    }
    
    resource appServiceApp 'Microsoft.Web/sites@2020-06-01' = {
      name: appServiceAppName
      location: location
      properties: {
        serverFarmId: appServicePlan.id
        httpsOnly: true
      }
    }
    
  5. Zapisz i zamknij plik app-service.bicep .

  6. Otwórz plik main.bicep .

  7. W obszarze deklaracji parametrów dodaj następującą deklarację parametru i definicję modułu:

    @description('The name of the App Service app. This name must be globally unique.')
    param appServiceAppName string = 'toyweb-${uniqueString(resourceGroup().id)}'
    
    module appService 'modules/app-service.bicep' = {
      name: 'app-service'
      params: {
        location: location
        environmentType: environmentType
        appServiceAppName: appServiceAppName
      }
    }
    
  8. Zapisz i zamknij plik main.bicep .

Porównanie różnic

Teraz, gdy wprowadziliśmy zmianę w pliku main.bicep , sprawdźmy różnice. Dobrym pomysłem jest przejrzenie różnic w każdym pliku, który zamierzasz przygotować i zatwierdzić, aby upewnić się, że nie zatwierdzasz przypadkowo żadnych zmian, których nie chcesz.

  1. W Visual Studio Code wybierz pozycję ViewSCM> lub naciśnij klawisze Ctrl+Shift+G na klawiaturze.

  2. Na panelu Kontrola źródła , który zostanie otwarty, wybierz plik main.bicep .

    Zostanie otwarty widok różnic plików.

    Screenshot of Visual Studio Code that shows the differences between the current main.bicep file and the modified version.

    Zwróć uwagę, że Visual Studio Code pokazuje wprowadzone zmiany. Oryginalny plik znajduje się po lewej stronie, a zmieniony plik znajduje się po prawej stronie. Dodatki do pliku są wyświetlane na zielono. Wszystkie usunięte elementy z pliku są wyświetlane na czerwono.

  3. Otwórz różnice w pliku app-service.bicep .

    Zwróć uwagę, że po lewej stronie widoku różnicy nie ma nic, ponieważ ten plik jest nowy i nie został jeszcze dodany do repozytorium.

Zatwierdź zaktualizowany kod Bicep przy użyciu Visual Studio Code

Po przejrzeniu zmian i ich zadowoleniu należy zatwierdzić aktualizację pliku. Tym razem użyjesz Visual Studio Code.

  1. Kontrola typu open source.

    Powinny zostać wyświetlone dwa zmienione pliki. Jeśli ich nie widzisz, wybierz przycisk odświeżenia, aby Visual Studio Code skanować pod kątem zmian.

    Screenshot of Visual Studio Code that shows Source Control, with the Refresh toolbar icon highlighted.

  2. Wybierz każdy z dwóch zmienionych plików i przygotuj je. Możesz wybrać ikonę plus (+) dla każdego pliku lub wybrać i trzymać (lub kliknąć prawym przyciskiem myszy) każdy plik i wybrać pozycję Zmiany etapu.

    Screenshot of Visual Studio Code that shows Source Control, with the main.bicep context menu displayed and the Stage Changes menu item highlighted.

  3. W górnej części kontrolki źródła wprowadź opisowy komunikat zatwierdzenia, na przykład:

    Add App Service module.
    
  4. Wybierz ikonę znacznika wyboru nad polem tekstowym komunikatu zatwierdzenia.

    Screenshot of Visual Studio Code that shows Source Control, with the commit icon highlighted.

    Visual Studio Code zatwierdza dwie zmiany.

Wyświetlanie historii zatwierdzń przy użyciu interfejsu wiersza polecenia usługi Git

  1. W terminalu Visual Studio Code wprowadź następujące polecenie, aby wyświetlić historię zatwierdzń repozytorium:

    git log --pretty=oneline
    

    Dane wyjściowe wyglądają podobnie do następujących:

    238b0867f533e14bcaabbade31b9d9e1bda6123b (HEAD -> main) Add App Service module.
    9e41f816bf0f5c590cee88590aacc977f1361124 Add first version of Bicep template.
    
  2. Sprawdź dane wyjściowe. Zwróć uwagę, że oba zatwierdzenia są wyświetlane w historii zatwierdzeń.

Wyświetlanie historii pliku przy użyciu Visual Studio Code

Możesz również wyświetlić historię pojedynczego pliku, stan pliku z tego zatwierdzenia oraz zmianę, którą zastosowano w zatwierdzeniu.

  1. Otwórz Eksploratora w Visual Studio Code.

  2. Wybierz i przytrzymaj (lub kliknij prawym przyciskiem myszy) plik main.bicep , a następnie wybierz pozycję Otwórz oś czasu.

    Screenshot of Visual Studio Code that shows the Explorer panel, with the shortcut menu displayed for the main.bicep file and the Timeline menu item highlighted.

    Zostanie otwarta oś czasu i zostanie wyświetlona obie zatwierdzenia.

    Screenshot of Visual Studio Code that shows the timeline for the main.bicep file, with two commits listed.

  3. Wybierz każde zatwierdzenie na liście, aby wyświetlić stan pliku w tym momencie w czasie.