# Розгортання робочих навантажень FlashData

Запустіть свій додаток або агента CLI завдання на Linux або Docker, після чого перевірте доступ і повторно зловживати після перезавантаження.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/production-deployment
Переглянуто: 2026-11-05 від FlashData

<a id="prepare"></a>

## 1. Виберіть робочий час

Використовуйте Linux хост з Bash і jq, і власник API ключ з дозволу google_search. Налаштування запуску як користувач OS, який буде виконувати завдання. Створіть цю папку приватного завдання для кроків 1–4; етикетки файлів показують будь-які підпапки.

### Створіть папку завдання

```bash
umask 077
mkdir -p "$HOME/flashdata-tasks/deployment-check"
cd "$HOME/flashdata-tasks/deployment-check"
```

### Сервер Linux

Встановіть рідну CLI першим. Запуск команди -v флешки, щоб знайти абсолютний шлях, потім встановити FLASHDATA_BIN до цього шляху в runtime.sh. Встановіть ім'я профілю та персистентний державний шлях, після чого зберегти файл.

#### runtime.sh

```bash
# runtime.sh — edit the executable and persistent state paths.
export FLASHDATA_BIN=/usr/local/bin/flashdata
export FLASHDATA_PROFILE=research
export FLASHDATA_STATE_DIR="$HOME/.local/state/flashdata-research"

run_flashdata() {
  env -u FLASHDATA_API_KEY "$FLASHDATA_BIN" "$@" \
    --profile "$FLASHDATA_PROFILE" \
    --state-dir "$FLASHDATA_STATE_DIR"
}
```


### Docker

На Linux Docker хост з curl, tar і sha256sum, завантажити пінений CLI для хост-процесу. Заощаджуйте image/Dockerfile і image/.dockerignore нижче, збудуйте зображення, потім заощаджуйте runtime.sh. За допомогою цього помічника працює як ваш UID/GID і монтує в кожну нову ємність.

#### Завантажити і перевірити Linux CLI

```bash
(
  set -euo pipefail
  case "$(uname -m)" in
    x86_64) arch=amd64 ;;
    aarch64|arm64) arch=arm64 ;;
    *) echo 'Use a Linux amd64 or arm64 host.' >&2; exit 1 ;;
  esac
  mkdir -p image
  cd image
  archive="flashdata_1.2.1_linux_$arch.tar.gz"
  base='https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1'
  curl --fail --show-error --location "$base/$archive" -o "$archive"
  curl --fail --show-error --location "$base/SHA256SUMS" -o SHA256SUMS
  awk -v file="$archive" '$2 == file { print }' SHA256SUMS | sha256sum -c -
  tar -xzf "$archive" flashdata
)
```

#### image/Dockerfile

```dockerfile
FROM debian:bookworm-slim
RUN apt-get update \
    && apt-get install -y --no-install-recommends ca-certificates \
    && rm -rf /var/lib/apt/lists/*
COPY --chmod=0755 flashdata /usr/local/bin/flashdata
USER 10001:10001
ENTRYPOINT ["/usr/local/bin/flashdata"]
```

#### image/.dockerignore

```text
*
!Dockerfile
!flashdata
```

#### Побудувати локальне зображення · не потрібно облікових записів

```bash
docker build --tag flashdata-runtime:1.2.1 ./image
docker run --rm flashdata-runtime:1.2.1 --version
```

#### runtime.sh

```bash
# runtime.sh — use the local image built above.
export FLASHDATA_IMAGE='flashdata-runtime:1.2.1'
export FLASHDATA_PROFILE=research
export FLASHDATA_STATE_DIR="$HOME/.local/state/flashdata-research"

run_flashdata() {
  docker run --rm -i --user "$(id -u):$(id -g)" \
    --env FLASHDATA_API_KEY= \
    --mount "type=bind,src=$FLASHDATA_STATE_DIR,dst=/state" \
    --mount "type=bind,src=$PWD,dst=/work" --workdir /work \
    --entrypoint /usr/local/bin/flashdata "$FLASHDATA_IMAGE" \
    "$@" --profile "$FLASHDATA_PROFILE" --state-dir /state
}
```

- [CLI реліз 1.2.1](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Docker двосторонні кріплення](https://docs.docker.com/engine/storage/bind-mounts/)

- [Встановити рідний CLI](https://flashdata.dev/uk/docs/guides/flashdata-cli/reference.md#install)
- [Власник ключів та дозволів](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md)

<a id="runtime-check"></a>

### Перевірити вибраний робочий час

Запуск з папки завдання. run_flashdata є помічником, збереженим в runtime.sh; всі пізніше команди використовують його профіль і державний каталог. Він ігнорує FLASHDATA_API_KEY так ключ навколишнього середовища не може замінити збережений профіль. Витратити CLI і jq версії.

#### Приготувати стійкий стан · без запиту API

```bash
set -euo pipefail
umask 077
. ./runtime.sh
mkdir -p "$FLASHDATA_STATE_DIR"
chmod 700 "$FLASHDATA_STATE_DIR"
run_flashdata --version
jq --version
```


<a id="secrets"></a>

## 2. Встановити доступ власника один раз

Якщо профіль вже має доступ власника, пропустіть імпорт і запустіть перевірку нижче. В іншому випадку, монтувати файл секрету власника, який читається користувачем сервісу і замінити шлях прикладу з його розташуванням. Імпорт прочитає його через stdin; Docker не копіює його в зображення.

### Точка до розгорнутого секретного файлу

```bash
export FLASHDATA_KEY_FILE='/run/secrets/flashdata_api_key'
```

### Імпорт і перевірка в вибраному режимі

```bash
set -euo pipefail
. ./runtime.sh
: "${FLASHDATA_KEY_FILE:?Set the path to your mounted owner-key secret}"
run_flashdata auth login --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
run_flashdata auth status --json --non-interactive
```

- [Прив’яжіть пробний доступ перед регулярним використанням](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md#claim)

<a id="access-check"></a>

### Підтвердження облікового запису та дозволу

Перевірити принти на рахунок ID, дозволені джерела та достовірність, потім true. Підтвердити обліковий запис ID є власником, перш ніж продовжити. access.json залишається в папці завдання для перевірки.

#### Ощадний доступ власника · безкоштовна перевірка

```bash
set -euo pipefail
umask 077
. ./runtime.sh
run_flashdata auth status --json --non-interactive > access.json
jq '{accountId: .data.identity.identity.accountId,
     sources: .data.identity.permittedSources,
     credentialProtection: .data.credentialProtection}' access.json
jq -e '.ok and .data.accessVerified
  and (.data.identity.identity.recurringAllowed == true)
  and (.data.identity.permittedSources | index("google_search") != null)' access.json
```


<a id="protection"></a>

### Почергове зберігання та персистентні файли

Огляд data.credentialProtection в auth status. Linux може використовувати розблокований секретний сервіс; безголовний хост або ємність, наданий, може використовуватися власноруч звичайний файл. Зберігати приватний каталог і стійкий до державного каталогу. Надання розгорнутого користувача окремо від зашифрованого профілю вашого ноутбука.

| Зареєструватися | Місцезнаходження |
| --- | --- |
| Редагування та робота журналу | FLASHDATA_STATE_DIR |
| Вхід, квитанції та результати | Тека завдання; встановлена як /work в Docker. |

- [Забезпечення та переміщення доступу](https://flashdata.dev/uk/docs/guides/agent-access/reference.md)

<a id="operate"></a>

## 3. Визначте запит та вартість

Заощаджуйте request.json з runtime.sh. Заявка на отримання коштів, що нараховується, та на вимогу, читає поточне ціноутворення та порівнює його з наявним балансом. Не залишає за собою право на пошук та не резервувати кредити. Продовжити тільки при фільтруванні true.

### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
```

### Перевірити перед першим платним завданням

```bash
set -euo pipefail
umask 077
. ./runtime.sh
run_flashdata account balance --json --non-interactive > balance.json
run_flashdata query --input request.json --mode realtime --dry-run --recurring \
  --run-id deployment-first-task --json --non-interactive > preflight.json
jq -e --slurpfile balance balance.json '
  .ok and .data.dryRun and .data.estimateAvailable
  and ($balance[0].ok == true)
  and any(.data.estimate.prices[]?;
    .source == "google_search" and .available == true
    and (.estimatedCredits | type == "number")
    and ($balance[0].data.availableCredits | type == "number")
    and .estimatedCredits <= $balance[0].data.availableCredits)
' preflight.json
```


<a id="restart-check"></a>

## 4. Перевірити один раз і перевірити повторно

Збережіть deployment-check.sh нижче. З новим розгортанням запустіть ID, перший виконання подає один платний пошук; другий запускає новий процес і прочитає збережений результат. Якщо цей ID вже завершений в одному профілі, обидва спроби його повторно використовувати.


<a id="check-script"></a>

### Зберегти deployment-check.sh

Створюйте deployment-check.sh біля runtime.sh і request.json в папці приватного завдання на хост. Скопіюйте загальний скрипт нижче в ньому і заощаджуйте його.

#### deployment-check.sh

```bash
#!/usr/bin/env bash
set -euo pipefail
umask 077
cd -- "$(dirname -- "$0")"
. ./runtime.sh
attempt=$(mktemp -d ./deployment-check.XXXXXX)
printf 'Attempt files: %s\n' "$attempt" >&2
cp -- request.json "$attempt/request.json"
if ! run_flashdata query --input "$attempt/request.json" --mode realtime --recurring \
  --run-id deployment-first-task --timeout 2m --json --non-interactive \
  --output "$attempt/result.json" \
  > "$attempt/receipt.json" 2> "$attempt/error.json"; then
  cat "$attempt/error.json" >&2
  exit 1
fi
jq -e '.ok == true' "$attempt/receipt.json" >/dev/null
jq -e '.source == "google_search" and .status == "done"
  and (.results[0].organic | type == "array")' "$attempt/result.json" >/dev/null
jq '{runId, cached, usage}' "$attempt/receipt.json"
printf 'Saved result: %s\n' "$attempt/result.json"
```


<a id="run-check"></a>

### Запуск збереженого чека двічі

Виконувати з цієї папки завдань, що містяться в одному режимі. Обидва процеси навантажують runtime.sh, що зберігається на крокі 1.

#### Запуск, потім перезавантажити процес

```bash
# A new run ID submits one paid search; a completed ID reuses its result.
bash deployment-check.sh

# New process; Docker uses a new container with the same mounts.
# Same account, input and state: cached: true, no new search.
bash deployment-check.sh
```


<a id="restart-result"></a>

### Перевірити другий чек

Для нового запуску, expect cached: false, потім cached: true. Кожна спроба друкує папку deployment-check.XXXXXX і зберігає request.json, receipt.json і error.json, плюс result.json на успіх. Запланований квитанція повідомляє про оригінальне використання. Не вдалося намагатися зберігати файли для відновлення.

#### Друге надходження · вилучення

```json
{
  "ok": true,
  "runId": "deployment-first-task",
  "cached": true
}
```

- [Відновити переривання роботи](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md)

<a id="read-result"></a>

### Читати результат збереженого пошуку

Встановіть ATTEMPT_DIR до другої успішної папки, надрукованої вище, наприклад, експорт ATTEMPT_DIR='./deployment-check.ABC123'. Ці команди читають лише локальні файли.

#### Отримання та вихідні посилання

```bash
# Use one attempt folder printed by deployment-check.sh.
: "${ATTEMPT_DIR:?Set a saved deployment-check.XXXXXX folder}"
jq '{runId, cached, usage}' "$ATTEMPT_DIR/receipt.json"
jq '.results[0].organic[] | {title, link, snippet}' "$ATTEMPT_DIR/result.json"
```


<a id="schedule"></a>

### Переміщення з перевірки розгортання до повторного завдання

Ця перевірка має фіксований хід ID. Для рекурентної роботи, дати кожному призначеному запобігання власної ID і збереження вибраного часу, облікового запису, вхідних знімків і державних кріплень. Адапувати команду запиту на транзисторний бігун для використання run_flashdata так Docker завдання, що залишаються всередині контейнера.

- [Реквізити IDs, квитанції та розклад](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md)

<a id="ci"></a>

## Перевірити доступ з GitHub Дії

Використовуйте перевірений, стійкий Linux бігун з Bash, jq і профілі CLI вже встановлений під користувачем OS. Заощаджуйте цей робочий процес в репозиторію заявки. Зареєструйтесь на сайті CLI без виконання платного завдання.

1. Призначте етикетку Flashdata-research до цього бігунка.
2. Налаштуйте репозиторійні змінні FLASHDATA_BIN і FLASHDATA_STATE_DIR до абсолютної доріжки, і FLASHDATA_PROFILE до встановленої назви профілю.

### .github/workflows/flashdata-check.yml

```yaml
name: FlashData access check
on: workflow_dispatch
permissions: {}
concurrency:
  group: flashdata-research
  cancel-in-progress: false
jobs:
  verify:
    runs-on: [self-hosted, linux, flashdata-research]
    timeout-minutes: 5
    steps:
      - name: Verify the installed profile without a paid query
        shell: bash
        env:
          FLASHDATA_BIN: ${{ vars.FLASHDATA_BIN }}
          FLASHDATA_STATE_DIR: ${{ vars.FLASHDATA_STATE_DIR }}
          FLASHDATA_PROFILE: ${{ vars.FLASHDATA_PROFILE }}
          FLASHDATA_API_KEY: ""
        run: |
          set -euo pipefail
          : "${FLASHDATA_BIN:?Set the absolute CLI path}"
          : "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
          : "${FLASHDATA_PROFILE:?Set the installed profile name}"
          test -d "$FLASHDATA_STATE_DIR"
          "$FLASHDATA_BIN" auth status --profile "$FLASHDATA_PROFILE" \
            --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive |
            jq -e '.ok and .data.accessVerified
              and (.data.identity.identity.recurringAllowed == true)
              and (.data.identity.permittedSources | index("google_search") != null)'
```

- [GitHub бігун етикетки](https://docs.github.com/en/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job)

<a id="ci-run"></a>

### Запуск перевірки доступу

Після збереження робочого процесу на відділенні за замовчуванням репозиторію, відкриті дії → Перевірка доступу FlashData → Запуск роботи. Очікуйте true і вдалим перевіркою. Просування доступу або дозволу не дає на роботу без подання запиту.


<a id="ci-state"></a>

### Зберігати стан виконання через робочі місця

Без оригінального журналу починається ефемерний бігун. Використовуйте міцний стан застосування або стійкий бігун для платної рецидивної роботи. Перевстановлення тільки ключ не може визначити попередню роботу. Зберігайте персональний каталог і завдання виводу; не завантажуйте їх як CI artifacts.


<a id="maintain"></a>

## Поворот або відкликання розгортання доступу

Відправлення пароля. У папці задачі пункт FLASHDATA_KEY_FILE на ключі заміни для того ж облікового запису та необхідних джерел, потім запустіть команди нижче. Повторіть контроль доступу і deployment-check.sh; expect cached: true. Відновити старий ключ після перевірки і зберегти профіль і державне каталог.

### Замініть ключ через stdin

```bash
set -euo pipefail
. ./runtime.sh
: "${FLASHDATA_KEY_FILE:?Point to the mounted replacement key for the same account}"
run_flashdata auth login --replace --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
run_flashdata auth status --json --non-interactive
```

- [Керування ключами API](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="revoke"></a>

### Зупинити доступ повністю

За допомогою графіка, відкликання ключа або з'єднання агента в консолі, після чого повторіть перевірку вільного доступу. Не потрібно. На диску залишаються локальні файли, які вивозяться на диску.


<a id="help"></a>

## Перевірка розгортання, що не вдається

| Симптом | Фіксація |
| --- | --- |
| Команда не знайдено / неправильна версія CLI | Перевірити команду -v flashdata і FLASHDATA_BIN в runtime.sh. Для Docker перебудувати і запустити перевірку зображення --version. |
| Змішані кріплення або дозвіл відхилено | Створіть папки держави та завдання на хост Docker, що належить до служби UID/GID. Зберігайте свої шляхи стабільними. |
| replacement_requires_flag | Профіль має різні збережені ключі. Перевірити наявний доступ першим; використовувати процедуру обертання для заміни за призначенням. |
| Не можна розшифрувати збережений доступ | Виконайте як користувач, який його забезпечив, в той же кримінал-store середовищі. Надання доступу на новий пункт замість копіювання зашифрованого профілю ноутбука. |
| Вартість перевірки повертається false | Огляд balance.json і preflight.json. Вимагати доступну ціну, дозвіл на джерело і достатній баланс перед поданням. |
| run_account_mismatch | Перевірити вибраний обліковий запис і API походження. Відновити оригінальний доступ; не перейменувати роботу для відновлення обходу. |
| run_id_input_conflict | Відновити оригінальний запит від request.json. Використовуйте новий запуск ID тільки для призначеного нового платного завдання. |
| CI залишається черги | Перевірити, що бігун онлайн і має кожен ходовий етикеток. Цей робочий процес вимагає стійкий самоприхований Linux. |

- [Відновити збережений запуск](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md)
