Среда разработки Chef Desktop

[редактировать на GitHub]

Приблизительное время: 1 час (с собственными виртуальными машинами)

Этот шаг знакомит вас с основами разработки кулинарных книг и показывает процесс создания, редактирования и тестирования простой кулинарной книги. Это те же основные шаги, на которые вы будете опираться при разработке вашей кулинарной книги Chef Desktop.

1. Изучение тестирования с Test Kitchen
2. Настройка среды разработки Chef
3. Создание демонстрационной кулинарной книги
4. Тестирование кулинарной книги локально
5. Тестирование кулинарной книги с помощью Test Kitchen после получения изображений виртуальных машин

Разработка и тестирование кулинарных книг для платформ Windows 10 и macOS

Тестирование является центральным элементом хорошей разработки программного обеспечения. Тестирование вашей кулинарной книги Chef Desktop предоставляет возможность обнаруживать и исправлять проблемы до внесения изменений в производство. Тестирование экономит время и деньги, но привносит ценность, помогая вашей организации достигать и поддерживать оперативную скорость.

Лицензии

Важно понимать вашу лицензию на операционную систему и соглашения об использовании сервисов. Лучше всего начать с поиска и понимания вашего SLA:

• Лицензии Windows
• SLA Apple macOS

Test Kitchen

Test Kitchen был установлен с Chef Workstation. Он предоставляет Chef Infra инструмент для тестирования кулинарных книг, использующий виртуальные машины (ВМ). Обратитесь к вашим лицензиям Apple и Microsoft, а также к соглашениям об уровне обслуживания (SLA), чтобы понять ваши возможности для приобретения или создания ВМ для разработки.

Интеграции Test Kitchen

Test Kitchen использует архитектуру плагинов драйверов, чтобы позволить Test Kitchen тестировать экземпляры на таких поставщиках облачных услуг, как Amazon EC2, Google Compute Engine и Microsoft Azure. Вы также можете тестировать на нескольких локальных гипервизорах, таких как VMware, Hyper-V или VirtualBox. Документация Test Kitchen и репозиторий GitHub Test Kitchen.

Настройка вашей среды разработки

На этом шаге вы подготовите свою рабочую станцию для разработки, тестирования и развертывания кулинарной книги Chef Desktop.

1. Создайте свой локальный репозиторий

   Вам понадобится локальный репозиторий на вашей рабочей станции для хранения ваших кулинарных книг и связанных работ Chef, а также для совместного использования с GitHub или другой системой управления версиями.

   Из командной строки в корневой папке (c:\ или ~/), выполните:

   chef generate repo my_repo
   

Создайте свою первую кулинарную книгу

Это практическая кулинарная книга, чтобы понять, как проводить тестирование.

1. Создайте свою кулинарную книгу

   chef generate cookbook my_repo/cookbooks/my_cookbook
   

2. Отредактируйте файл metadata.rb

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

   name 'my_cookbook'
   maintainer 'The Authors'
   maintainer_email 'you@example.com'
   license 'All Rights Reserved'
   description 'Installs/Configures my_cookbook'
   version '0.1.0'
   chef_version '>= 16.0'
   

3. Отредактируйте рецепт по умолчанию

   Откройте my_repo\cookbook\my_cookbook\recipes\default.rb в Visual Studio и добавьте:

   Для Windows:

   powershell_script 'get my path' do
     code <<-CODE
     [Environment]::GetEnvironmentVariable("Path")
     CODE
   end
   

   Для macOS:

   bash 'get my path' do
     user 'root'
     code <<-EOH
     echo $PATH
     EOH
   end
   

   • Отступы имеют значение! Будьте внимательны к отступам
   • Используйте LF для переноса строк, а не CRLF. (Обратите внимание на нижнюю правую часть строки состояния в Visual Studio Code)

Протестируйте свою кулинарную книгу

В командной строке перейдите в каталог вашей кулинарной книги. Этот путь должен быть похожим на c:\my_repo\cookbooks\my_cookbook. Затем выполните следующую команду для тестирования вашего кода:

cd c:\my_repo\cookbooks\my_cookbook
chef-client -z -o my_cookbook

Вы должны увидеть путь к кулинарной книге, отображенный в выводе команды «run». Если она не запустилась или вернула ошибку, вернитесь назад и проверьте свою орфографию и отступы.

Тестирование с помощью Test Kitchen

1. Применение кулинарных книг к изображениям

   Выполните следующую команду, чтобы применить, или «слить», кулинарные книги с базовым образом ОС:

   kitchen converge
   

2. Проверка настроек

   Подтвердите, что слитный код — это тот код, который вы хотели применить. В VSCode перейдите в каталог test\integration\default и изучите сгенерированные интеграционные тесты. Тщательно пройдитесь по этим тестам и скорректируйте их, чтобы они соответствовали настройкам изменениям в файле default.rb. Затем выполните:

   kitchen verify
   

3. Очистка

   После завершения тестирования вы можете выполнить следующую команду, чтобы удалить запущенные тестовые образы:

   kitchen destroy
   

Тест Kitchen

После знакомства с Test Kitchen вы можете выполнить все шаги сразу, включая очистку, с помощью:

kitchen test

• Далее: Среда разработки кулинарных книг Chef Desktop
• Предыдущее: Установка компонентов Chef