← Cloudflare Flagship / flagship / reference

Команды Wrangler

Используйте wrangler flagship чтобы управлять приложениями Flagship и флагами функций из командной строки. Каждая wrangler flagship flags команда принимает идентификатор приложения в качестве первого аргумента. Большинство подкоманд затем принимают ключ флага, например wrangler flagship flags get <APP_ID> <KEY>. Команды в виде списков, такие как wrangler flagship flags list <APP_ID>, принимают только идентификатор приложения.

wrangler flagship обращается к API Cloudflare. Перед выполнением команд авторизуйте Wrangler:

wrangler login

Для автоматизации задайте CLOUDFLARE_API_TOKEN к API-токен с соответствующими разрешениями Flagship.

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

Добавьте привязку Flagship в проект Worker, чтобы код Worker мог оценивать флаги с низкой задержкой во время выполнения:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "flagship": [
    {
      "binding": "FLAGS",
      "app_id": "<APP_ID>"
    }
  ]
}

[[flagship]]
binding = "FLAGS"
app_id = "<APP_ID>"

Создайте булев флаг, оцените его для пользователя и отключите как аварийный выключатель:

# With no variations, Wrangler creates on=true, off=false,
# and serves off by default.
wrangler flagship flags create <APP_ID> new-checkout

# Evaluate the flag for a user.
wrangler flagship flags evaluate <APP_ID> new-checkout --targeting-key user-42

# Disable the flag instantly. Disabled flags always serve their default variation.
wrangler flagship flags disable <APP_ID> new-checkout

Приложения объединяют связанные флаги. Распространённый подход: одно приложение на сервис, Worker или продуктовую область.

wrangler flagship apps ls является псевдонимом для apps list. wrangler flagship apps rm является псевдонимом для apps delete.

wrangler flagship apps list автоматически обрабатывает постраничную загрузку и отображает все приложения в аккаунте.

При создании приложения возвращается его идентификатор и отображается фрагмент привязки для добавления в конфигурацию Wrangler:

wrangler flagship apps create checkout-service

Чтобы добавить новое приложение в ваш wrangler.json или wrangler.jsonc файл как привязку Worker, передайте --binding:

wrangler flagship apps create checkout-service --binding FLAGS

Wrangler также поддерживает --update-config чтобы обновить конфигурацию JSON или JSONC после запроса имени привязки.

Для конфигурационных файлов не в формате JSON Wrangler выводит фрагмент привязки, но не редактирует файл автоматически.

Когда --json используется, apps create выводит созданное приложение в формате JSON и не запрашивает и не обновляет конфигурацию.

В скриптах получайте идентификатор приложения из вывода JSON:

APP_ID=$(wrangler flagship apps create checkout-service --json | jq -r '.id')

При удалении приложения удаляются все его флаги и история изменений. Если Worker всё ещё ссылается на приложение через привязку Flagship, API отклоняет удаление.

Используйте --force или -y чтобы пропустить запрос подтверждения удаления. Если вы также используете --json, необходимо передать --force чтобы запрос подтверждения не мог появиться в выводе JSON.

wrangler flagship apps delete <APP_ID> --force

Чтобы удалить несколько приложений, передайте несколько ID приложений:

wrangler flagship apps delete <APP_ID_1> <APP_ID_2> <APP_ID_3> --force

Ключи флагов уникальны в рамках приложения. Используйте стабильные ключи, описывающие управляемое поведение, например new-checkout, pricing-page-layout, или upload-limit.

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

wrangler flagship flags create <APP_ID> new-checkout

Используйте --variation (-V) чтобы добавить каждый вариант как name=value. Используйте --default чтобы выбрать запасной вариант.

# String flag.
wrangler flagship flags create <APP_ID> checkout-flow \
	-V v1=old-checkout \
	-V v2=new-checkout \
	--default v1 \
	--type string

# Number flag.
wrangler flagship flags create <APP_ID> upload-limit \
	-V free=10 \
	-V pro=100 \
	-V enterprise=1000 \
	--default free \
	--type number

# JSON flag.
wrangler flagship flags create <APP_ID> theme-config \
	-V 'light={"bg":"#ffffff","fg":"#111111"}' \
	-V 'dark={"bg":"#111111","fg":"#ffffff"}' \
	--default light \
	--type json

Поддерживаемые типы значений: boolean, string, number, а также json. Если --type не указан, Wrangler самостоятельно определяет скалярный тип каждого значения.

Все варианты флага должны использовать один и тот же тип значения. Wrangler отклоняет флаг, если его варианты приводят к разным типам, например один boolean и один number, ещё до отправки запроса. Передайте --type явно, чтобы привести все варианты к одному типу.

Используйте --description (-d) чтобы задокументировать назначение флага:

wrangler flagship flags create <APP_ID> checkout-flow \
	-V v1=old-checkout \
	-V v2=new-checkout \
	--default v1 \
	--type string \
	--description "Controls which checkout experience is served"

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

Используйте --disabled чтобы создать флаг, который предоставляет вариант по умолчанию, пока вы его не включите.

wrangler flagship flags create <APP_ID> coming-soon \
	-V on=true \
	-V off=false \
	--default off \
	--disabled

Правила таргетинга определяют, какой вариант показать для заданного контекста оценки. Передавайте правила с помощью --rule или --rule-json.

Компактный --rule синтаксис использует сегменты, разделённые точкой с запятой:

serve=<VARIATION>; when=<CONDITIONS>; rollout=<PERCENT>%@<ATTRIBUTE>; priority=<NUMBER>

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"

Условия сравнивают атрибуты из контекста оценки со значениями правила. Компактный синтаксис поддерживает все Операторы Flagship:

--rule "serve=on; when=plan equals pro"
--rule "serve=on; when=country in [US,CA,UK]"
--rule "serve=off; when=email ends_with @example.com"
--rule "serve=strict; when=score less_than 20"

Используйте AND и OR чтобы объединить условия. AND имеет более высокий приоритет, чем OR.

# Both conditions must match.
--rule "serve=on; when=plan equals pro AND country equals US"

# Either condition can match.
--rule "serve=on; when=plan equals enterprise OR plan equals team"

# Equivalent to: (plan=pro AND country=US) OR plan=enterprise.
--rule "serve=on; when=plan equals pro AND country equals US OR plan equals enterprise"

AND и OR зарезервированы как логические операторы, если встречаются вне значений в кавычках или списков. Заключайте значения в одинарные или двойные кавычки, если они содержат зарезервированные слова или разделители, например AND, OR, ;, или ,:

--rule 'serve=on; when=title equals "WAR AND PEACE" OR title equals "tom; jerry"'
--rule 'serve=on; when=country in ["US","CA"]'

Для in и not_in, передайте список в квадратных скобках. Wrangler отклоняет некорректные списки, пустые элементы списка, незакрытые кавычки и несбалансированные скобки до отправки запроса.

Используйте --rule-json для глубоко вложенных логических групп или если вы предпочитаете передавать структуру правила API напрямую. Wrangler проверяет --rule-json на соответствие схеме правил Flagship и отклоняет неизвестные или конфликтующие поля.

wrangler flagship flags create <APP_ID> beta-features \
	-V on=true \
	-V off=false \
	--default off \
	--rule-json '{"serve_variation":"on","conditions":[{"logical_operator":"OR","clauses":[{"attribute":"beta","operator":"equals","value":true},{"attribute":"plan","operator":"equals","value":"enterprise"}]}]}'

Повторите --rule или --rule-json чтобы объявить несколько правил. Правила оцениваются в порядке приоритета. Побеждает первое подходящее правило.

wrangler flagship flags create <APP_ID> rate-limit-tier \
	-V strict=50 \
	-V normal=200 \
	-V relaxed=1000 \
	--default normal \
	--type number \
	--rule "serve=strict; when=score less_than 20" \
	--rule "serve=relaxed; when=score greater_than_or_equals 90"

Wrangler проверяет дублирующиеся приоритеты правил, повторяющиеся имена вариаций, некорректные списки, недопустимые числовые значения, такие как Infinity, и неизвестные имена вариантов перед отправкой запроса.

Список флагов в приложении:

wrangler flagship flags list <APP_ID>

Команда list использует постраничный вывод. Используйте --limit и --cursor для ручной постраничной загрузки, или --all чтобы получить все страницы.

wrangler flagship flags list <APP_ID> --limit 50
wrangler flagship flags list <APP_ID> --cursor <CURSOR>
wrangler flagship flags list <APP_ID> --all

Просмотр полного определения флага:

wrangler flagship flags get <APP_ID> new-checkout

wrangler flagship flags ls является псевдонимом для flags list. wrangler flagship flags inspect является псевдонимом для flags get.

wrangler flagship flags update считывает текущий флаг, применяет ваши изменения и записывает полное определение флага обратно в API.

wrangler flagship flags update <APP_ID> new-checkout \
	--description "Redesigned checkout experience"

wrangler flagship flags update <APP_ID> upload-limit \
	--set-variation team=500

wrangler flagship flags update <APP_ID> upload-limit \
	--remove-variation team

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

wrangler flagship flags update <APP_ID> checkout-flow \
	--set-variation experiment=new-checkout-v2

Чтобы очистить его, передайте пустое описание:

wrangler flagship flags update <APP_ID> new-checkout --description ""

Когда вы добавляете или заменяете вариации у существующего флага, используйте --type если Wrangler должен привести новые значения к определенному типу:

wrangler flagship flags update <APP_ID> upload-limit \
	--type number \
	--set-variation team=500

Wrangler проверяет, что итоговый набор вариаций сохраняет единый тип значений и что вариация по умолчанию и правила таргетинга по-прежнему ссылаются на существующие вариации.

Флаг также можно включить или отключить через flags update, хотя flags enable и flags disable короче для сценариев аварийного отключения:

wrangler flagship flags update <APP_ID> new-checkout --disable
wrangler flagship flags update <APP_ID> new-checkout --enable

wrangler flagship flags set <APP_ID> checkout-flow --variation v2

Используйте --clear-rules если новое значение по умолчанию должно показываться всем.

wrangler flagship flags set <APP_ID> checkout-flow --variation v2 --clear-rules

Используйте --rule или --rule-json чтобы заменить весь набор правил:

wrangler flagship flags update <APP_ID> premium-banner \
	--rule "serve=on; when=plan equals pro AND country not_in [CN,RU]"

Используйте --add-rule или --add-rule-json чтобы добавить правила, не изменяя существующие:

wrangler flagship flags update <APP_ID> premium-banner \
	--add-rule "serve=off; when=account_age less_than 7"

wrangler flagship flags update <APP_ID> premium-banner \
	--add-rule-json '{"serve_variation":"off","conditions":[{"attribute":"country","operator":"in","value":["CN","RU"]}]}'

Удаление всех правил:

wrangler flagship flags update <APP_ID> premium-banner --clear-rules

Используйте rules list чтобы увидеть приоритеты, на которые можно ссылаться в командах для конкретных правил:

wrangler flagship flags rules list <APP_ID> premium-banner

Flagship оценивает правила по возрастанию priority; побеждает первое подходящее правило. Используйте rules reorder чтобы изменить порядок существующих правил, не переписывая все условия.

Передайте существующие приоритеты в новом порядке. Wrangler перенумерует их в 1..n в этом порядке:

wrangler flagship flags rules reorder <APP_ID> rate-limit-tier --order 2,1

Если существующие приоритеты были 1=strict и 2=relaxed, это делает relaxed приоритет 1 и strict приоритет 2.

Используйте rules update чтобы изменить одно правило по приоритету, сохранив остальную часть набора правил.

Изменение только процента развёртывания:

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

Изменение варианта, который возвращает правило:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--serve off

Изменение условий правила:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--when "plan equals enterprise OR plan equals team"

Удалите условия из правила, чтобы оно соответствовало любому контексту оценки:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--clear-conditions

Удаление развёртывания из правила:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--clear-rollout

Используйте rules delete чтобы удалить одно правило по приоритету:

wrangler flagship flags rules delete <APP_ID> premium-banner --priority 2

После удаления правила Wrangler перенумеровывает оставшиеся правила, чтобы приоритеты оставались непрерывными.

Отключение флага работает как мгновенный аварийный выключатель. Отключённый флаг игнорирует правила таргетинга и возвращает вариацию по умолчанию.

wrangler flagship flags disable <APP_ID> new-checkout
wrangler flagship flags enable <APP_ID> new-checkout

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

wrangler flagship flags disable <APP_ID> new-checkout dark-mode premium-banner
wrangler flagship flags enable <APP_ID> new-checkout dark-mode premium-banner

Используйте rollout чтобы предоставлять один вариант определённому проценту трафика.

wrangler flagship flags rollout <APP_ID> new-checkout \
	--to on \
	--percentage 25 \
	--by user_id

Используйте --from-variation (псевдоним --from) чтобы выбрать запасной вариант для оставшегося трафика. Процент постепенного развёртывания 0 удаляет правило постепенного развёртывания и оставляет текущий вариант флага по умолчанию без изменений.

rollout отправляет указанный вами процент напрямую в Flagship. Например, --percentage 25 --to on предоставляет on вариант к 25% трафика, прошедшего bucketing. Оставшийся трафик переходит к варианту флага по умолчанию.

Используйте split для A/B тестов или распределения трафика между несколькими вариантами. Wrangler преобразует веса в накопительные пороги постепенного релиза.

wrangler flagship flags split <APP_ID> checkout-flow \
	--weight v1=80 \
	--weight v2=20 \
	--by user_id

-w является псевдонимом для --weight. Каждый вариант можно взвесить только один раз, а веса должны быть конечными неотрицательными числами.

Веса задаются относительно друг друга. Wrangler суммирует веса, переводит каждый из них в процент от общей суммы и отправляет в Flagship накопленные пороговые значения. Например, --weight v1=80 --weight v2=20 отправляет два сгенерированных правила: одно для v1 с процентом постепенного развёртывания 80, и одно для v2 с процентом постепенного развёртывания 100. Это создаёт диапазоны бакетов 0-80 для v1 и 80-100 для v2.

При трех весах, --weight a=50 --weight b=30 --weight c=20 превращается в накопительные пороги 50, 80, а также 100. Варианты с нулевым весом пропускаются.

Используйте --default с split чтобы выбрать запасной вариант, когда bucketing невозможен:

wrangler flagship flags split <APP_ID> checkout-flow \
	--weight v1=80 \
	--weight v2=20 \
	--default v1 \
	--by user_id

wrangler flagship flags rollout <APP_ID> new-checkout --to on --percentage 100 --force

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

wrangler flagship flags evaluate <APP_ID> new-checkout

wrangler flagship flags evaluate <APP_ID> new-checkout \
	--targeting-key user-42

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

Используйте --targeting-key для стабильной группировки при процентном постепенном релизе. Передавайте каждый атрибут контекста с --context name=value. wrangler flagship flags eval является псевдонимом для flags evaluate.

--context можно указывать несколько раз. --ctx и -C являются псевдонимами:

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

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

Результат оценки включает:

Flagship регистрирует события создания, изменения и удаления для каждого флага. История изменений отображается от новых к старым:

wrangler flagship flags changelog <APP_ID> new-checkout

Используйте элементы управления пагинацией для длинной истории:

wrangler flagship flags changelog <APP_ID> new-checkout --limit 10
wrangler flagship flags changelog <APP_ID> new-checkout --cursor <CURSOR>
wrangler flagship flags changelog <APP_ID> new-checkout --all

wrangler flagship flags history является псевдонимом для flags changelog.

wrangler flagship flags delete <APP_ID> coming-soon

Используйте --force или -y чтобы пропустить запрос подтверждения. Если вы также используете --json, необходимо передать --force чтобы запрос подтверждения не мог появиться в выводе JSON.

wrangler flagship flags delete <APP_ID> coming-soon --force

wrangler flagship flags rm является псевдонимом для flags delete.

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

wrangler flagship flags delete <APP_ID> coming-soon old-checkout temporary-banner --force

Каждый wrangler flagship команда принимает --json. Вывод в формате JSON отключает баннер Wrangler и предназначен для использования в скриптах.

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

Массовые команды, например flags delete, flags enable, а также flags disable, продолжайте обработку оставшихся флагов, если один флаг завершается ошибкой. В режиме JSON частичные сбои возвращают объект ошибки JSON с успешными results и для каждого флага failures.

Команды, которые могут обновлять wrangler.json или wrangler.jsonc, например apps create --binding, не запрашивайте и не обновляйте конфигурацию, если --json используется.

Создайте приложение, сохраните его идентификатор, затем создайте флаг:

APP_ID=$(wrangler flagship apps create checkout-service --json | jq -r '.id')

wrangler flagship flags create "$APP_ID" new-checkout --json

Удалите несколько приложений в цикле:

for app_id in <APP_ID_1> <APP_ID_2> <APP_ID_3>; do
	wrangler flagship apps delete "$app_id" --force
done

Либо укажите ID приложений напрямую:

wrangler flagship apps delete <APP_ID_1> <APP_ID_2> <APP_ID_3> --force

Следующий справочник создан на основе Wrangler flagship определения команд.

flagship apps create

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

npx wrangler flagship apps create [NAME]

• [NAME]string обязательно

  Имя приложения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

• --use-remoteboolean

  Используйте удалённую привязку при добавлении только что созданного ресурса в конфигурацию

• --update-configboolean

  Автоматически обновлять файл конфигурации, добавляя в него новый ресурс

• --bindingstring

  Имя привязки этого ресурса в вашем Worker

flagship apps list

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

npx wrangler flagship apps list

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship apps get

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

npx wrangler flagship apps get [APP-ID]

• [APP-ID]string обязательно

  ID приложения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship apps update

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

npx wrangler flagship apps update [APP-ID]

• [APP-ID]string обязательно

  ID приложения

• --namestring обязательно

  Новое имя приложения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship apps delete

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

npx wrangler flagship apps delete [APP-ID]

• [APP-ID]string обязательно

  Один или несколько ID приложений для удаления

• --forceboolean псевдоним: --yпо умолчанию: false

  Пропустить запрос подтверждения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags create

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --variationstring псевдоним: --V

  Вариант флага в формате "name=value" (можно указывать несколько раз)

• --default-variationstring псевдоним: --default

  The name of the variation to serve by default (defaults to off for boolean flags, otherwise the first variation)

• --typestring псевдоним: --t

  Тип значения варианта (определяется автоматически, если не указан)

• --descriptionstring псевдоним: --d

  Описание флага

• --disabledboolean по умолчанию: false

  Создание флага в отключенном состоянии

• --rulestring

  Правило таргетинга, например "serve=on; when=plan equals pro AND region in [US,CA]; rollout=30%@user_id". Условия поддерживают AND/OR; priority необязателен и по умолчанию равен порядку объявления (можно указывать несколько раз)

• --rule-jsonstring

  Правило таргетинга в виде объекта JSON (можно указывать несколько раз)

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags list

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

npx wrangler flagship flags list [APP-ID]

• [APP-ID]string обязательно

  ID приложения

• --limitnumber

  Максимальное количество возвращаемых флагов (1-200)

• --cursorstring

  Курсор пагинации из предыдущего вызова list

• --allboolean по умолчанию: false

  Получите все флаги с автоматическим переходом по страницам

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags get

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags update

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --enableboolean

  Включить флаг

• --disableboolean

  Отключить флаг

• --descriptionstring псевдоним: --d

  Новое описание флага (чтобы очистить его, передайте "")

• --default-variationstring псевдоним: --default

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

• --typestring псевдоним: --t

  Тип значения, используемый для приведения значений --set-variation

• --set-variationstring

  Добавьте или замените вариацию в формате "name=value"

• --remove-variationstring

  Удаление варианта по имени

• --rulestring

  Замена правил таргетинга флага (повторяемый параметр)

• --rule-jsonstring

  Замена правил таргетинга флага с помощью JSON (повторяемый параметр)

• --add-rulestring

  Добавляет правило таргетинга, сохраняя существующие правила (можно указывать многократно)

• --add-rule-jsonstring

  Добавляет правило таргетинга в формате JSON, сохраняя существующие правила (можно указывать многократно)

• --clear-rulesboolean по умолчанию: false

  Удаление всех правил таргетинга

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags set

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --variationstring псевдонимы: --variant, --Vобязательно

  Вариант, используемый по умолчанию

• --clear-rulesboolean по умолчанию: false

  Удалите правила таргетинга, чтобы этот вариант всегда показывался

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags rules list

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags rules update

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --prioritynumber обязательно

  Приоритет обновляемого правила

• --servestring

  Вариант, который используется при срабатывании этого правила

• --whenstring

  Условия правила, используя тот же синтаксис, что и --rule when=...

• --clear-conditionsboolean по умолчанию: false

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

• --rolloutstring

  Раскатка в формате "percentage" или "percentage%@attribute"

• --clear-rolloutboolean по умолчанию: false

  Удаление rollout из этого правила

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags rules delete

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --prioritynumber обязательно

  Приоритет удаляемого правила

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags rules reorder

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --orderstring обязательно

  Приоритеты существующих правил в новом порядке через запятую, например 2,1,3

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags split

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --weightstring псевдоним: --w

  Вес варианта в формате "variation=weight" (можно указывать несколько раз)

• --bystring

  Атрибут контекста, используемый для sticky bucketing

• --default-variationstring псевдоним: --default

  Резервный вариант на случай, если bucketing не может быть выполнен

• --forceboolean псевдоним: --yпо умолчанию: false

  Пропустить запрос подтверждения, если это разделение заменяет существующие правила таргетинга

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags rollout

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --tostring обязательно

  Вариант для развёртывания

• --percentagenumber обязательно

  Процент трафика для обслуживания варианта развёртывания (0-100)

• --bystring

  Атрибут контекста, используемый для sticky bucketing

• --from-variationstring псевдоним: --from

  Резервный вариант для оставшегося трафика

• --forceboolean псевдоним: --yпо умолчанию: false

  Пропустить запрос подтверждения, если это развёртывание заменяет существующие правила таргетинга

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags enable

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Один или несколько ключей флагов для включения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags disable

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Один или несколько ключей флагов для отключения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags evaluate

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --contextstring псевдонимы: --ctx, --C

  Контекст оценки в формате "name=value" (можно указывать несколько раз)

• --targeting-keystring

  Стабильный ключ bucketing для процентных развёртываний

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags delete

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Один или несколько ключей флагов для удаления

• --forceboolean псевдоним: --yпо умолчанию: false

  Пропустить запрос подтверждения

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON

flagship flags changelog

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

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

• [APP-ID]string обязательно

  ID приложения

• [KEY]string обязательно

  Ключ флага

• --limitnumber

  Максимальное количество возвращаемых записей (1-200)

• --cursorstring

  Курсор пагинации из предыдущего вызова changelog

• --allboolean по умолчанию: false

  Получите все записи с автоматическим переходом по страницам

• --jsonboolean по умолчанию: false

  Возвращает вывод в формате JSON