Skip to content

docs(atak): add demo-day playbook for jetson-compose-refresh - #96

Merged
jdev-02 merged 9 commits into
mainfrom
jon/atak-readme-jetson-refresh
May 3, 2026
Merged

docs(atak): add demo-day playbook for jetson-compose-refresh#96
jdev-02 merged 9 commits into
mainfrom
jon/atak-readme-jetson-refresh

Conversation

@jdev-02

@jdev-02 jdev-02 commented May 3, 2026

Copy link
Copy Markdown
Owner

Why

PR #92 lands the `make jetson-compose-refresh` target and the script behind it. Right now only Kyle knows the recipe (where to run it, what envs to set, how it interacts with the existing systemd autoupdate path). For demo day we want anyone on the team to be able to push the latest `main` to the Jetson if Kyle is unavailable.

What

Adds a "Demo-Day Playbook" section to the top of `atak/README.md`:

  • The single command (after first-time setup):
    ```
    make jetson-compose-refresh
    ```
  • The 5-step internal flow that target runs (pull → stop systemd → `docker compose down/up` → curl smoke-test against `atakAgentBtn`).
  • Env-var overrides table (`REPO_DIR`, `BRANCH`, `SERVICE_NAME`, `PLANNER_URL`, ...).
  • The `.env` template the compose service reads on the Jetson (`OLLAMA_`, `ANTHROPIC_API_KEY`, `CESIUM_ION_TOKEN`, `TERA_ATAK_`).
  • A short "two refresh paths" subsection clarifying that we now have two ways to keep the Jetson current — native systemd autoupdate vs Docker compose refresh — and you should pick one (port 8080 conflict otherwise). Recommends the Docker path for the hackathon demo.

The original Jetson Setup, ATAK Device Setup, and Troubleshooting sections are untouched.

Depends on

Test

Adds a top-of-README "Demo-Day Playbook" section that gives Kyle (and
anyone covering for him) the single command to pull main, rebuild the
Docker compose service, and smoke-test the new build:

  make jetson-compose-refresh

Documents:
- The 5-step internal flow of the new make target.
- Env-var overrides (BRANCH, REPO_DIR, SERVICE_NAME, etc.).
- The repo-root .env template the compose service reads (OLLAMA_*,
  ANTHROPIC_API_KEY, CESIUM_ION_TOKEN, TERA_ATAK_*).
- Disambiguates "native systemd autoupdate" vs "Docker compose refresh"
  as the two refresh paths and recommends the Docker path for the
  hackathon demo (reproducible + isolated).

The original Jetson Setup, ATAK Device Setup, and Troubleshooting
sections are untouched.

Depends on: #92 (introduces the `jetson-compose-refresh` target +
deploy/scripts/jetson_compose_refresh.sh that this playbook references).
@jdev-02
jdev-02 requested a review from benschwierking as a code owner May 3, 2026 07:53
@jdev-02
jdev-02 merged commit a9df343 into main May 3, 2026
2 checks passed
@jdev-02
jdev-02 deleted the jon/atak-readme-jetson-refresh branch May 3, 2026 09:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant