Упражнение. Фиксация файлов в репозитории и просмотр их журнала

Завершено

В предыдущем упражнении вы инициализировали репозиторий Git для веб-сайта компании по продаже игрушек. Вы добавили файл Bicep, но не зафиксировали его.

В этом упражнении вы выполните следующие действия.

• Зафиксируйте файл, созданный в предыдущем упражнении.
• Добавьте новый модуль Bicep и сравните различия в коде Bicep с помощью Git.
• Зафиксируйте обновленный код Bicep.
• Просмотрите журнал фиксации и журнал главного файла Bicep.

Процесс внесения дополнительных изменений в код Bicep продемонстрирует отслеживание изменений и управление ими с помощью Git и Visual Studio Code.

Фиксация файла Bicep с помощью CLI Git

1. В окне терминала Visual Studio Code выполните следующую команду, чтобы подготовить файл main.bicep:

   git add deploy/main.bicep
   

2. Выполните следующую команду, чтобы зафиксировать подготовленные изменения и предоставить сообщение о фиксации:

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

Добавление модуля Bicep

Здесь вы добавляете модуль Bicep и ссылаетесь на него из файла main.bicep.

1. В папке deploy создайте вложенную папку с именем modules.

2. В папке modules создайте новый файл с именем app-service.bicep.

3. Откройте и сохраните пустой файл app-service.bicep, куда Visual Studio Code загрузит средства Bicep.

4. Скопируйте следующий код в 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@2024-04-01' = {
     name: appServicePlanName
     location: location
     sku: {
       name: appServicePlanSkuName
       tier: appServicePlanTierName
     }
   }
   
   resource appServiceApp 'Microsoft.Web/sites@2024-04-01' = {
     name: appServiceAppName
     location: location
     properties: {
       serverFarmId: appServicePlan.id
       httpsOnly: true
     }
   }
   

5. Сохраните и закройте файл app-service.bicep.

6. Откройте файл main.bicep.

7. Под объявлениями параметров добавьте следующее объявление параметра и определение модуля:

   @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. Сохраните и закройте файл main.bicep.

Сравнение различий

Теперь, когда вы внесли изменения в файл main.bicep, рассмотрим различия. Рекомендуется ознакомиться с различиями в каждом файле, который вы будете выполнять этап и фиксацию. Проверьте правильность изменений.

1. В Visual Studio Code выберите Представление>Управление источниками или нажмите клавиши Ctrl+Shift+G на клавиатуре.

2. На открывшейся панели Система управления версиями выберите файл main.bicep.

   Откроется представление различий между файлами.

   

   Обратите внимание, что Visual Studio Code отображает внесенные изменения. Исходный файл находится слева, а измененный файл — справа. Дополнения к файлу выделены зеленым цветом. При изменении файла и удалении содержимого удаляются красным цветом.

3. Откройте различия для файла app-service.bicep.

   Обратите внимание, что левая часть представления различий пуста, так как этот файл является новым и еще не добавлен в репозиторий.

Фиксация обновленного кода Bicep с помощью Visual Studio Code

Если вы проверили изменения и довольны ими, зафиксируйте обновление в файле. В этот раз вы будете использовать Visual Studio Code.

1. Откройте систему управления версиями.

   Должны появиться два измененных файла. Если вы их не видите, нажмите кнопку обновления, чтобы редактор Visual Studio Code проверил наличие изменений.

   

2. Выберите два измененных файла и подготовьте их. Можно выбрать значок плюса (+) для каждого файла либо выбрать и удерживать (или щелкнуть правой кнопкой мыши) каждый файл, а затем выбрать пункт Хранить промежуточные изменения.

   

3. В верхней части системы управления версиями введите описательное сообщение о фиксации, например:

   Add App Service module
   

4. Выберите значок галочки над текстовым полем для сообщения о фиксации. Или можно выбрать "Зафиксировать".

   

   Visual Studio Code фиксирует два изменения.

Просмотр журнала фиксаций с помощью CLI Git

1. В окне терминала Visual Studio Code введите следующую команду, чтобы просмотреть журнал фиксаций репозитория:

   git log --pretty=oneline
   

   Результат должен быть аналогичным приведенному ниже:

   238b0867f533e14bcaabbade31b9d9e1bda6123b (HEAD -> main) Add App Service module
   9e41f816bf0f5c590cee88590aacc977f1361124 Add first version of Bicep template
   

2. Изучите выходные данные. Обратите внимание, что обе фиксации отображаются в журнале фиксаций.

Просмотр журнала файла с помощью Visual Studio Code

Можно также просмотреть журнал одного файла, состояние файла из этой фиксации и изменение, примененное фиксацией.

1. Откройте Обозреватель в Visual Studio Code.

2. Выберите и удерживайте (или щелкните правой кнопкой мыши) файл main.bicep, а затем выберите пункт меню Открыть временную шкалу.

   

   Откроется временная шкала, на которой отображаются обе фиксации.

   

3. Выберите каждую фиксацию в списке, чтобы просмотреть состояние файла на данный момент времени.