# นำงาน FlashData ขึ้นระบบ

เปิดแอพหรือตัวแทนของคุณ CLI งานบน Linux หรือ Dockerจากนั้นตรวจสอบการเข้าถึงและผลลัพธ์ที่นํากลับมาใช้อีกครั้งหลังจากการรีเซ็ท

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/production-deployment
Recorder: 2026-11-05 โดย FlashData

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

## 1. เลือกเวลาทํางาน

ใช้ Linux โฮสต์พร้อม Bash ถึง jqและเป็นเจ้าของ API กุญแจพร้อม google_search อนุญาต เรียกใช้การตั้งค่าเป็น OS ผู้ใช้ที่จะประมวลผลงาน สร้างโฟลเดอร์ทาสก์ส่วนตัวสําหรับขั้นตอนต่าง ๆ 1–4สืบค้นเมื่อ '% 1'

### สร้างโฟลเดอร์ทาสก์

```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 โฮสต์พร้อม curlTar และ Shha256sum, ดาวน์โหลดที่ตรึง CLI สําหรับ CPU ของโฮสต์ บันทึก 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/th/docs/guides/flashdata-cli/reference.md#install)
- [กุญแจเจ้าของและสิทธิ์ที่อนุญาต](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md)

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

### เลือกเวลาทํางานที่เลือกไว้

ประมวลผลจากโฟลเดอร์ทาสก์ run_flashdata ผู้ช่วยเหลือถูกบันทึกใน runtime.shสืบค้นเมื่อ% 1 มันไม่สนใจ 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/th/docs/guides/agent-onboarding/reference.md#claim)

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

### ยืนยันการอนุญาตบัญชีผู้ใช้

เช็ค ลายนิ้วมือของบัญชี IDงั้น ก็ให้แหล่งข่าวและ การคุ้มครองตามหลักการได้ true. ยืนยันบัญชีผู้ใช้ ID คือเจ้าของที่ตั้งใจไว้ก่อนจะทําต่อ access.json อยู่ในโฟลเดอร์ทาสก์สําหรับตรวจสอบ

#### บันทึกการเข้าใช้เครื่องหมาย 'H' ฟรี

```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 ใช้บริการลับที่ไม่ได้ปลดล็อคได้; โฮสต์ที่ไม่มีหัวหรือตู้เก็บจดหมายด้านบนอาจจะใช้เพียงแฟ้มข้อความธรรมดาของเจ้าของเครื่องเท่านั้น เก็บไดเร็คทอรีของรัฐไว้เป็นส่วนตัวและต่อเนื่อง จัดเรียงผู้ใช้ที่ใช้งานแยกจากโพรไฟล์การเข้ารหัสของแล็ปท็อปของคุณ

| เก็บไว้ | ตําแหน่ง |
| --- | --- |
| Credentials และประมวลผลบันทึกประจําวัน | FLASHDATA_STATE_DIR |
| การนําเข้า, ใบเสร็จและผลที่ได้ | โฟลเดอร์ทาสก์; ถูกเมานท์ไว้ /work ใน Docker. |

- [การจัดการและย้ายสิทธิ์ในการเข้าใช้](https://flashdata.dev/th/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
  }
}
```

### Check before print february

```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>

### ตรวจสอบใบเสร็จใบที่สอง

สําหรับรอบใหม่, คาดหวัง 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/th/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/th/docs/guides/recurring-tasks/reference.md)

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

## ตรวจสอบสิทธิ์ที่เข้าใช้ GitHub การกระทํา

จง ใช้ ความ ไว้ วางใจ อย่าง ไม่ ละลด Linux ลงสมัครด้วย Bash, jq และ CLI โพรไฟล์ถูกติดตั้งไว้เรียบร้อยแล้วภายใต้ชื่อตัววิ่ง OS ผู้ใช้ บันทึกการทํางานนี้ไว้ในคลังแพกเกจของโปรแกรมของคุณ มันจะตรวจสอบโฮสต์ CLI โดยไม่ทํางานงานที่ต้องจ่าย

1. กําหนดป้ายค้นหา flashdata ให้นักวิ่งคนนั้น
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>

### ตรวจสอบสิทธิ์

หลังบันทึก workflow ในสาขาเริ่มต้นของ repository แล้ว เปิด Actions → FlashData access check → Run workflow ผลควรเป็น true และการตรวจสอบสำเร็จ หากไม่มีข้อมูลรับรองหรือสิทธิ์ งานจะล้มเหลวโดยไม่ส่งคำขอค้นหา


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

### ให้รัฐประมวลผลระหว่างงาน

นักวิ่งแบบ ephermeral เริ่มต้นโดยไม่มีบันทึกต้นฉบับ ใช้โปรแกรมที่ทนทานหรือรันเนอร์ถาวร สําหรับการทํางานซ้ํา ๆ การติดตั้งเฉพาะกุญแจเท่านั้น ที่ไม่สามารถระบุการส่งงานก่อนหน้านี้ได้ เก็บไดเร็คทอรีของรัฐและงานที่ส่งออกเป็นส่วนตัว; อย่าอัปโหลดมัน เยี่ยงสิ่งประดิษฐ์ของ 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/th/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>

## เช็คการรับสมัครที่ล้มเหลว

| Sumpotom | แก้ไข |
| --- | --- |
| ไม่พบคําสั่ง / ผิด CLI รุ่น | ตรวจสอบคําสั่ง - v แฟลชดาต้าและ FLASHDATA_BIN ใน runtime.sh. สําหรับ Dockerสร้างใหม่และดําเนินภาพ --version เช็ค |
| ถูกปฏิเสธการเมานท์หรือไม่ได้รับอนุญาต | สร้างโฟลเดอร์สถานะและงานบนระบบ Docker เจ้าภาพ เจ้าของบริการ UID/GID. รักษาเส้นทางของพวกเขาให้มั่นคง |
| replacement_requires_flag | โปรไฟล์มีกุญแจอีกแบบนึง ตรวจสอบสิทธิ์ที่ใช้ก่อนใช้กระบวนการหมุนเพื่อทําการแทนที่ที่ต้องการ |
| ไม่สามารถถอดรหัสการเข้าใช้ที่บันทึกไว้ | ประมวลผลในฐานะผู้ใช้ที่จัดหามัน ในสภาพแวดล้อมเดียวกัน การจัดทําการเข้าถึงจุดหมายปลายทางใหม่แทนการคัดลอกโพรไฟล์แล็ปท็อปที่ถูกเข้ารหัสไว้ |
| การตรวจสอบเงินตรา false | ขอบเขตสี balance.json ถึง preflight.json. ต้องการราคาที่ใช้ได้ ใบอนุญาตจากแหล่ง และความสมดุลพอ ก่อนการยินยอม |
| run_account_mismatch | Checkบัญชีที่เลือกไว้ API ต้นกําเนิด เรียกคืนสิทธิ์ที่เรียกใช้ครั้งแรก ไม่ต้องเปลี่ยนชื่อการประมวลผลเพื่อทําการกู้คืนแบบบายพาส |
| run_id_input_conflict | เรียกคืนคําร้องขอเดิมจากความพยายาม request.json. ใช้การประมวลผลใหม่ ID สําหรับงานที่ตั้งใจไว้ |
| CI คงคิวไว้ | ตรวจสอบว่านักวิ่งออนไลน์ และมีชื่อเรียกทุกชื่อ การทํางานแบบนี้ต้องใช้การควบคุมตัวเองอย่างถาวร Linux นักวิ่ง |

- [กู้ข้อมูลการทํางานที่บันทึกไว้](https://flashdata.dev/th/docs/guides/agent-recovery/reference.md)
