Переглянути документацію
Посібники
Запустіть свій додаток або агента CLI завдання на Linux або Docker, після чого перевірте доступ і повторно зловживати після перезавантаження.
На цій сторінці
1. Виберіть робочий час
Використовуйте Linux хост з Bash і jq, і власник API ключ з дозволу google_search. Налаштування запуску як користувач OS, який буде виконувати завдання. Створіть цю папку приватного завдання для кроків 1–4; етикетки файлів показують будь-які підпапки.
umask 077
mkdir -p "$HOME/flashdata-tasks/deployment-check"
cd "$HOME/flashdata-tasks/deployment-check"Встановіть рідну CLI першим. Запуск команди -v флешки, щоб знайти абсолютний шлях, потім встановити FLASHDATA_BIN до цього шляху в runtime.sh. Встановіть ім'я профілю та персистентний державний шлях, після чого зберегти файл.
# 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"
}На Linux Docker хост з curl, tar і sha256sum, завантажити пінений CLI для хост-процесу. Заощаджуйте image/Dockerfile і image/.dockerignore нижче, збудуйте зображення, потім заощаджуйте runtime.sh. За допомогою цього помічника працює як ваш UID/GID і монтує в кожну нову ємність.
(
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
)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"]*
!Dockerfile
!flashdatadocker build --tag flashdata-runtime:1.2.1 ./image
docker run --rm flashdata-runtime:1.2.1 --version# 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
}Перевірити вибраний робочий час
Запуск з папки завдання. run_flashdata є помічником, збереженим в runtime.sh; всі пізніше команди використовують його профіль і державний каталог. Він ігнорує FLASHDATA_API_KEY так ключ навколишнього середовища не може замінити збережений профіль. Витратити CLI і jq версії.
set -euo pipefail
umask 077
. ./runtime.sh
mkdir -p "$FLASHDATA_STATE_DIR"
chmod 700 "$FLASHDATA_STATE_DIR"
run_flashdata --version
jq --version2. Встановити доступ власника один раз
Якщо профіль вже має доступ власника, пропустіть імпорт і запустіть перевірку нижче. В іншому випадку, монтувати файл секрету власника, який читається користувачем сервісу і замінити шлях прикладу з його розташуванням. Імпорт прочитає його через stdin; Docker не копіює його в зображення.
export FLASHDATA_KEY_FILE='/run/secrets/flashdata_api_key'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Підтвердження облікового запису та дозволу
Перевірити принти на рахунок ID, дозволені джерела та достовірність, потім true. Підтвердити обліковий запис ID є власником, перш ніж продовжити. access.json залишається в папці завдання для перевірки.
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Почергове зберігання та персистентні файли
Огляд data.credentialProtection в auth status. Linux може використовувати розблокований секретний сервіс; безголовний хост або ємність, наданий, може використовуватися власноруч звичайний файл. Зберігати приватний каталог і стійкий до державного каталогу. Надання розгорнутого користувача окремо від зашифрованого профілю вашого ноутбука.
| Зареєструватися | Місцезнаходження |
|---|---|
| Редагування та робота журналу | FLASHDATA_STATE_DIR |
| Вхід, квитанції та результати | Тека завдання; встановлена як /work в Docker. |
3. Визначте запит та вартість
Заощаджуйте request.json з runtime.sh. Заявка на отримання коштів, що нараховується, та на вимогу, читає поточне ціноутворення та порівнює його з наявним балансом. Не залишає за собою право на пошук та не резервувати кредити. Продовжити тільки при фільтруванні true.
{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}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.json4. Перевірити один раз і перевірити повторно
Збережіть deployment-check.sh нижче. З новим розгортанням запустіть ID, перший виконання подає один платний пошук; другий запускає новий процес і прочитає збережений результат. Якщо цей ID вже завершений в одному профілі, обидва спроби його повторно використовувати.
Зберегти deployment-check.sh
Створюйте deployment-check.sh біля runtime.sh і request.json в папці приватного завдання на хост. Скопіюйте загальний скрипт нижче в ньому і заощаджуйте його.
#!/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"Запуск збереженого чека двічі
Виконувати з цієї папки завдань, що містяться в одному режимі. Обидва процеси навантажують runtime.sh, що зберігається на крокі 1.
# 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Перевірити другий чек
Для нового запуску, expect cached: false, потім cached: true. Кожна спроба друкує папку deployment-check.XXXXXX і зберігає request.json, receipt.json і error.json, плюс result.json на успіх. Запланований квитанція повідомляє про оригінальне використання. Не вдалося намагатися зберігати файли для відновлення.
{
"ok": true,
"runId": "deployment-first-task",
"cached": true
}Читати результат збереженого пошуку
Встановіть ATTEMPT_DIR до другої успішної папки, надрукованої вище, наприклад, експорт ATTEMPT_DIR='./deployment-check.ABC123'. Ці команди читають лише локальні файли.
# 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"Переміщення з перевірки розгортання до повторного завдання
Ця перевірка має фіксований хід ID. Для рекурентної роботи, дати кожному призначеному запобігання власної ID і збереження вибраного часу, облікового запису, вхідних знімків і державних кріплень. Адапувати команду запиту на транзисторний бігун для використання run_flashdata так Docker завдання, що залишаються всередині контейнера.
Перевірити доступ з GitHub Дії
Використовуйте перевірений, стійкий Linux бігун з Bash, jq і профілі CLI вже встановлений під користувачем OS. Заощаджуйте цей робочий процес в репозиторію заявки. Зареєструйтесь на сайті CLI без виконання платного завдання.
- Призначте етикетку Flashdata-research до цього бігунка.
- Налаштуйте репозиторійні змінні FLASHDATA_BIN і FLASHDATA_STATE_DIR до абсолютної доріжки, і FLASHDATA_PROFILE до встановленої назви профілю.
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)'Запуск перевірки доступу
Після збереження робочого процесу на відділенні за замовчуванням репозиторію, відкриті дії → Перевірка доступу FlashData → Запуск роботи. Очікуйте true і вдалим перевіркою. Просування доступу або дозволу не дає на роботу без подання запиту.
Зберігати стан виконання через робочі місця
Без оригінального журналу починається ефемерний бігун. Використовуйте міцний стан застосування або стійкий бігун для платної рецидивної роботи. Перевстановлення тільки ключ не може визначити попередню роботу. Зберігайте персональний каталог і завдання виводу; не завантажуйте їх як CI artifacts.
Поворот або відкликання розгортання доступу
Відправлення пароля. У папці задачі пункт FLASHDATA_KEY_FILE на ключі заміни для того ж облікового запису та необхідних джерел, потім запустіть команди нижче. Повторіть контроль доступу і deployment-check.sh; expect cached: true. Відновити старий ключ після перевірки і зберегти профіль і державне каталог.
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Зупинити доступ повністю
За допомогою графіка, відкликання ключа або з'єднання агента в консолі, після чого повторіть перевірку вільного доступу. Не потрібно. На диску залишаються локальні файли, які вивозяться на диску.
Перевірка розгортання, що не вдається
| Симптом | Фіксація |
|---|---|
| Команда не знайдено / неправильна версія 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. |