INTEGRITY Документация

← Cloudflare Workers / workers / wrangler / commands

Флагман

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

wrangler flagship доступен в Wrangler версии v4.107.0 и более поздних.

Аутентификация

Запустите wrangler login, либо задайте CLOUDFLARE_API_TOKEN к API-токену с правами Flagship.

Разрешение Требуется для
flagship:read Просмотр приложений, проверка и вычисление флагов, а также чтение журналов изменений.
flagship:write Создание, обновление, удаление, включение, отключение, поэтапное развертывание и разделение приложений или флагов.

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

App IDs

wrangler flagship flags команды всегда принимают app ID в качестве первого аргумента. Большинство подкоманд затем принимают ключ флага; команды для вывода списков, такие как flags list, принимают только ID приложения:

wrangler flagship flags get <APP_ID> new-checkout
wrangler flagship flags disable <APP_ID> new-checkout
wrangler flagship flags list <APP_ID>

Если у вас ещё нет приложения, сначала создайте его:

wrangler flagship apps create checkout-service

Передайте --binding <NAME> при создании приложения, чтобы добавить его в ваш wrangler.json или wrangler.jsonc файл как привязку Worker.

Типичные сценарии работы

Создайте логический флаг. Если вариантов нет, Wrangler создаёт on=true, off=false, и обслуживает off по умолчанию:

wrangler flagship flags create <APP_ID> new-checkout

Добавьте правила таргетинга с помощью компактного синтаксиса правил:

wrangler flagship flags create <APP_ID> premium-banner \
	-V on=true \
	-V off=false \
	--default off \
	--rule "serve=on; when=plan equals enterprise AND country in [US,CA]; rollout=25%@user_id"

Используйте заглавные буквы AND и OR вне значений в кавычках для объединения условий. Заключайте в кавычки значения, содержащие зарезервированные слова или разделители:

wrangler flagship flags create <APP_ID> banner-copy \
	-V shown=true \
	-V hidden=false \
	--default hidden \
	--rule 'serve=shown; when=title equals "WAR AND PEACE" OR country in ["US","CA"]'

Для глубоко вложенных групп условий используйте --rule-json. Wrangler проверяет как компактные правила, так и правила в формате JSON перед отправкой запросов.

Измените одно существующее правило без переписывания всего набора правил:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--rollout 50%@user_id

Оценка флага для пользователя:

wrangler flagship flags evaluate <APP_ID> premium-banner \
	--context plan=enterprise \
	--context country=US \
	--targeting-key user-42

Используйте disable как аварийный выключатель:

wrangler flagship flags disable <APP_ID> premium-banner

Включайте, отключайте или удаляйте несколько флагов, указав ID приложения и несколько ключей:

wrangler flagship flags disable <APP_ID> new-checkout dark-mode premium-banner
wrangler flagship flags delete <APP_ID> coming-soon old-banner --force

Команды удаления требуют --force при использовании с --json чтобы промпты не могли нарушить формат JSON на выходе. rollout и split требуют того же самого, если они заменяют существующие правила таргетинга, у которых есть условия.

См. Справочник по основным командам Wrangler полное руководство по правилам таргетинга, постепенным развёртываниям, разделению трафика, журналам изменений и написанию скриптов с --json.

Команды

flagship apps create

Создайте приложение Flagship

npx wrangler flagship apps create [NAME]

Глобальные флаги

flagship apps list

Получить список Flagship-приложений

npx wrangler flagship apps list

Глобальные флаги

flagship apps get

Получение приложения Flagship

npx wrangler flagship apps get [APP-ID]

Глобальные флаги

flagship apps update

Обновите приложение Flagship

npx wrangler flagship apps update [APP-ID]

Глобальные флаги

flagship apps delete

Удалить приложение Flagship

npx wrangler flagship apps delete [APP-ID]

Глобальные флаги

flagship flags create

Создайте флаг функции в приложении Flagship

npx wrangler flagship flags create [APP-ID] [KEY]

Глобальные флаги

flagship flags list

Список флагов функциональности в приложении Flagship

npx wrangler flagship flags list [APP-ID]

Глобальные флаги

flagship flags get

Получение флага функции из приложения Flagship

npx wrangler flagship flags get [APP-ID] [KEY]

Глобальные флаги

flagship flags update

Обновите feature flag в приложении Flagship

npx wrangler flagship flags update [APP-ID] [KEY]

Глобальные флаги

flagship flags set

Настройка варианта по умолчанию, выдаваемого feature flag

npx wrangler flagship flags set [APP-ID] [KEY]

Глобальные флаги

flagship flags rules list

Список правил таргетинга для флага функциональности

npx wrangler flagship flags rules list [APP-ID] [KEY]

Глобальные флаги

flagship flags rules update

Обновите одно правило таргетинга для feature flag

npx wrangler flagship flags rules update [APP-ID] [KEY]

Глобальные флаги

flagship flags rules delete

Удалить одно правило таргетинга из флага функции

npx wrangler flagship flags rules delete [APP-ID] [KEY]

Глобальные флаги

flagship flags rules reorder

Изменение порядка правил таргетинга для флага функции

npx wrangler flagship flags rules reorder [APP-ID] [KEY]

Глобальные флаги

flagship flags split

Разделяйте трафик между вариантами по процентному соотношению

npx wrangler flagship flags split [APP-ID] [KEY]

Глобальные флаги

flagship flags rollout

Разверните один вариант для процента трафика

npx wrangler flagship flags rollout [APP-ID] [KEY]

Глобальные флаги

flagship flags enable

Включите флаг функциональности

npx wrangler flagship flags enable [APP-ID] [KEY]

Глобальные флаги

flagship flags disable

Отключить флаг функции

npx wrangler flagship flags disable [APP-ID] [KEY]

Глобальные флаги

flagship flags evaluate

Оценка флага функции с дополнительным контекстом

npx wrangler flagship flags evaluate [APP-ID] [KEY]

Глобальные флаги

flagship flags delete

Удалить флаг функции из приложения Flagship

npx wrangler flagship flags delete [APP-ID] [KEY]

Глобальные флаги

flagship flags changelog

Показать журнал изменений для флага функции

npx wrangler flagship flags changelog [APP-ID] [KEY]

Глобальные флаги