# حجم العمل المدفوع من FlashData

تشغيل تطبيقك أو وكيل وكيل CLI المهام الموكلة إلى Linux أو Dockerثم التحقق من الوصول والنتيجة إعادة الاستخدام بعد العودة.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/production-deployment
Reviewed: 2026-11-05 by FlashData

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

## 1. اختر وقت الجري

استخدم مضيف Linux مع Bash وjq ومفتاح API للمالك بصلاحية google_search. نفّذ الإعداد بمستخدم نظام التشغيل الذي سيشغّل المهمة. أنشئ مجلد المهام الخاص هذا للخطوات 1–4؛ وتُظهر تسميات الملفات أي مجلدات فرعية.

### إنشاء ملف المهمة

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

### خادوم Linux

Install the native CLI أولاً اديروا القيادة -في (ففيلداتا) لإيجاد طريقها المطلق، ثم وضعوا 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

على a Linux Docker مضيف curl(تار) و(ها256سوم) يحمّل الملصقات 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 release 1.2.1](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Docker bind mounts](https://docs.docker.com/engine/storage/bind-mounts/)

- [Install the native CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#install)
- [مفتاح المالك والإذن](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md)

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

### تحققوا من وقت التشغيل المختار

اهرب من ملف المهمة run_flashdata هو المساعد الذي أنقذه runtime.sh; All later commands use its profile and state directory. وهو يتجاهل 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/ar/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>

### تخزين الوثائق وملفاتها الثابتة

Inspect data.credentialProtection in auth status. ويمكن أن تستخدم شركة Linux جهازاً سرياً غير مقفل؛ ويمكن للمضيف الذي لا رأس له أو الحاوية المذكورة أعلاه أن يستخدم ملفاً للمدعوين فقط. أبقي دليل الولاية خاص ومستمر زود المستعمل المنتشر على انفراد من ملفك المحمول

| استمر | الموقع |
| --- | --- |
| وثائق التفويض والادارة اليومية | FLASHDATA_STATE_DIR |
| المدخلات والإيصالات والنتائج | The task folder; mounted as /work in Docker. |

- [توفير إمكانية الوصول والتنقل](https://flashdata.dev/ar/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>

### Save 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>

### اجري الشيك المنقذ مرتين

اهرب من ملف المهمة المستضيف مثل نفس مستعمل الخدمة Both processes load the runtime.sh save in step 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>

### يُصدّر الإيصال الثاني

للركض الجديد، نتوقع cached: false، ثم cached: true. وتطبع كل محاولة ملفها من طراز deployment-check.XXXXXX، وتحتفظ برقم request.json و receipt.json و error.json، بالإضافة إلى result.json على النجاح. التسلّم المكبوّل يُبلغ عن الاستخدام الأصلي. محاولة فاشلة تبقي ملفاتها للتعافي

#### الاستلام الثاني: مقتطف

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

- [إسترجعْ a مُقاطعَ مَرْك](https://flashdata.dev/ar/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 المهام تبقى داخل الحاوية

- [Recurring IDs, receipts and scheduling](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)

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

## تحقق من الوصول من إجراءات GitHub

استخدموا جهازاً ثابتاً من طراز Linux مع Bash، jq، وجهاز تصنيف (CLI) تم تركيبه بالفعل تحت مستعمل الـ (جرينر OS). احفظ هذا التدفق في مستودع طلبك ويتحقق من مضيف شركة CLI دون القيام بمهمة مدفوعة الأجر.

1. أرسلي بطاقة (فلادداتا) إلى ذلك الهارب.
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 runner labels](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>

### افحصي الشيك

بعد حفظ سير العمل في الفرع الافتراضي للمستودع، افتح Actions → FlashData access check → Run workflow. توقّع true وفحصًا ناجحًا. يفشل التنفيذ عند غياب الوصول أو الصلاحية دون إرسال بحث.


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

### أبقوا الإعدام في الولاية عبر الوظائف

الركض الفموي يبدأ بدون المجلة الأصلية استخدام دولة تطبيق دائمة أو حاكم ثابت للعمل المتكرر المدفوع الأجر. إعادة تركيب المفتاح فقط لا يمكن تحديد رسالة وظيفة سابقة. إبقاء دليل الدولة ونواتج العمل خاصة؛ لا تحميلها على أنها مصنوعات يدوية من طراز CI.


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

## تناوب أو إلغاء إمكانية الوصول إلى الموقع

أوقف الإرسال مؤقتًا. داخل مجلد المهمة، وجّه FLASHDATA_KEY_FILE إلى مفتاح بديل للحساب نفسه والمصادر المطلوبة، ثم شغّل الأوامر أدناه. أعد فحص الوصول وdeployment-check.sh؛ وتوقّع 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/ar/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>

## عمليات التحقق من النشر التي تفشل

| الرمز | Fix |
| --- | --- |
| لم يتم العثور على القيادة/نسخة خاطئة من CLI | تحقق من أمر القيادة - V flashdata و FLASHDATA_BIN في runtime.sh. For Dockerإعادة بناء و تشغيل الصورة --version تحقق. |
| المبلغ المفقود أو الإذن الممنوح | أنشئ مجلدي الحالة والمهام على مضيف Docker، بملكية UID/GID الخاصين بالخدمة. احتفظ بمساريهما ثابتين. |
| replacement_requires_flag | الملف لديه مفتاح مختلف منقذ التحقق من إمكانية الوصول القائمة أولاً؛ استخدام إجراء التناوب لاستبدال معتزم. |
| لا يمكن فك التشفير | تشغيل مثل المستعمل الذي زوده، في نفس بيئة المخزن الإبداعي. توفير إمكانية الوصول إلى وجهة جديدة بدلا من نسخ ملف محمول مشفر. |
| عائدات التحقق من التكاليف false | Inspect balance.json and preflight.json. (ب) اشتراط السعر المتاح، وإذن المصدر، والتوازن الكافي قبل تقديم الطلب. |
| run_account_mismatch | تحقق من الحساب المختار وعناوين API الأصلية. استعد الوصول الأصلي؛ ولا تعِد تسمية التنفيذ لتجاوز الاستعادة. |
| run_id_input_conflict | إعادة الطلب الأصلي من المحاولة request.json. (أ) استخدام طائرة جديدة من طراز ID فقط لمهمة جديدة مدفوعة. |
| CI يَبْقى مَسْتُولَ | تحقق من أن الهارب على الإنترنت ولديه كل بطاقة تشغيلية ويتطلب تدفق العمل هذا راكضاً من طراز Linux ذاتياً باستمرار. |

- [إسترجعوا ركضا منقذا](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)
