Быстрый пуск: Использование Salesforce CLI с DevOps Center

Настройка ожидаемых продаж

Создайте ожидаемые продажи, добавьте и настройте их этапы, активируйте ожидаемые продажи и вложите проект.

1. Составьте список проектов для поиска кода проекта.

   sf devops project list --target-org my-devops-org

   Скопируйте код проекта, который нужно вложить в ожидаемые продажи. Примеры быстрого запуска используют 0Hn000000000001.

2. Создайте неактивные ожидаемые продажи и подключите их к хранилищу.

   sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo

   Скопируйте код ожидаемых продаж из вывода команды. Примеры быстрого запуска используют 0XB000000000001.

   Ожидаемые продажи остаются неактивными до настройки их этапов и активации.

   Чтобы создать хранилище при создании ожидаемых продаж, используйте --create-repo с --repo-type github|bitbucket.

3. Добавьте этапы в ожидаемые продажи. Новый ожидаемый продажи содержит конечный этап по умолчанию. Добавьте каждый новый этап перед существующим, указав текущий этап с --next-stage-id.

   Например, добавьте этап интеграции.

   sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Integration" --next-stage-id 0Xc000000000001

   Скопируйте код этапа из вывода команды. Остальные примеры используют 0Xc000000000005 для этапа интеграции. Повторите команду для каждого дополнительного этапа, например, UAT.

   

   Совет Просмотрите ожидаемые продажи в пользовательском интерфейсе DevOps Center, чтобы получить коды этапов для последующих команд. Или запустите sf devops pipeline get --pipeline-id 0XB000000000001.
4. Настройте каждый этап. Каждый этап требует наличия ответвления и среды. Настройте этапы справа налево, поскольку конечный этап должен иметь ответвление, прежде чем настраивать предшествующие этапы.

   Добавьте ответвление к этапу интеграции. Флажок --create-vcs-branch создает ответвление в хранилище, если оно не существует.

   sf devops stage branch add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --branch-name integration --create-vcs-branch

   Добавьте безопасную среду к этапу.

   sf devops stage environment add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --environment-name Integration_Org --org-type Sandbox

   Открывается окно обозревателя, позволяющее авторизовываться в среде. Используйте --org-type Production для производственных организаций. В среде без заголовка добавьте --no-browser и выполните инструкции проверки подлинности, возвращенные командой.

   Повторите команды ответвления и среды для каждого этапа. Используйте имя филиала, имя среды и тип организации, подходящий для каждого этапа.

5. Активируйте ожидаемые продажи.
   

   Важно! Этап ожидаемых продаж не может быть изменен после продвижения изменений. Прежде чем выполнить данную команду, убедитесь в правильной настройке всех этапов.

   sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --activate

6. Вложите проект DevOps Center в ожидаемые продажи.

   sf devops pipeline project add --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001

   Конвейеры готовы. Создайте рабочие элементы в пользовательском интерфейсе DevOps Center или выполните команду sf devops work-item create.

Управление рабочим элементом

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

1. Задайте статусу рабочего элемента значение «Выполняется». DevOps Center создает ответвление функции для рабочего элемента.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "In Progress"

2. Извлеките ответвление функции из подключенного хранилища и просмотрите его в локальном проекте.

   git fetch origin
   git checkout WI-000042

3. Извлеките изменения из организации разработки. Данный пример извлекает класс Apex из организации с псевдонимом my-sandbox.

   sf project retrieve start --target-org my-sandbox --metadata ApexClass:MyNewClass

4. Просмотрите извлеченные файлы, разместите их, подтвердите и активируйте ответвление функции.

   git status
   git add force-app
   git commit -am "Implement new feature"
   git push origin WI-000042

   Настройте путь, переданный git add, если проект Salesforce DX использует другой каталог пакетов.

5. Создайте запрос на изменение (запрос на извлечение) для объединения ответвления функции в целевое ответвление.

   sf devops review create --target-org my-devops-org --work-item-name WI-000042

6. Дождитесь утверждения и объединения запроса на изменение рабочей группой.
7. Обновите статус рабочего элемента, чтобы указать, что он готов к продвижению.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "Ready to Promote"

Продвижение рабочего элемента

Продвиньте рабочий элемент на следующий этап ожидаемых продаж. DevOps Center проверяет рекламную акцию, запускает тестовые пакеты, настроенные для целевого этапа, и развертывает изменения, если тесты пройдены.

1. Продвигайте рабочий элемент, используя код рабочего элемента и код целевого этапа.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --target-stage-id 0Xc000000000002

   Результат команды содержит код запроса. Используйте его для проверки статуса рекламной акции.

   Status: Completed
   Message: Work items successfully promoted to UAT.
   Request ID: a0B000000000001
   
   Promoted Work Items
   ───────────────────
   0Wx000000000042

2. Используйте код запроса для проверки статуса рекламной акции.

   sf devops request status --target-org my-devops-org --request-token a0B000000000001

Общие задачи

Используйте эти команды во время ежедневного бизнес-правила разработки.

1. Продвигайте несколько рабочих элементов на один этап. Укажите --work-item-id один раз для каждого рабочего элемента.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --work-item-id 0Wx000000000043 --target-stage-id 0Xc000000000002

2. Разверните внешние объединенные изменения на этапе, не синхронизированном с DevOps Center.

   sf devops promotion complete --target-org my-devops-org --target-stage-id 0Xc000000000002

Расширенные сценарии использования

После завершения базового бизнес-правила используйте эти команды для рекламных акций, требующих больше контроля.