Skip to content

obc data v2 · P8 — Cutover, deletion and documentation #2656

Open

Description

@timohueser

Part of #2648. Read the epic first: it holds the model and the decisions.

Goal

The new system serves production, the old pipelines are gone, and the documentation describes only the new system.

Scope

  1. First real prod update (owner action, with an owner-approved review ID):

    • a regional coverage through obc data update prod on the bake VPS;
    • the follower serves it;
    • the web planner, map builder, desktop app, iOS and a device read it.
  2. Retire the legacy serving: stop the old VPS units (obc-data-planner-*, obc-planner-*-{0,1}) and remove their Caddy files.

  3. Remove legacy R2 keys (reference/v1/, the old cell-catalog/ and planner/ objects) only after equivalent new data is live and the owner approves the list of keys.

  4. Delete:

    • obc bake and host/obc-bake;
    • obc planner with tools/planner.py, planner_bake.py, planner_components.py and tools/planner-regions/;
    • obc r2 and tools/r2.py;
    • the osm-trails and mapzen-terrain-tiles sources;
    • the bake, planner and r2 recipes in tools/justfile;
    • .github/workflows/bake.yml (or rewrite it to call obc data update).

    Check obc governs for each deleted path and update the suites in tools/testing/suites.toml.

  5. Documentation, in their own docs: commit:

    • specs/obc-data.md: bytes and layouts only;
    • docs/content/software/data.md: the guide (the six nouns, staleness, targets and machines, publishing, the follower), listed in nav.json;
    • host/obc-data/README.md: setup, credentials, commands;
    • the planner section of builder/web/src/components/planner/README.md;
    • specs/planner-release.md, so the catalogue section matches the new pointer.

    Run python3 docs/build_docs.py --check-links and obc prose --check.

  6. Close the old issues: the owner closes EPIC — obc data: one system for data sources, bakes, releases and local environments #2410, obc data: fix the first-bake blockers and take the simple path #2612 and their open children as superseded by EPIC — obc data, second design: versioned layers, targets and one operator page #2648.

Acceptance

  • Prod serves data from the new system.
  • No code path writes to the bucket except obc data.
  • The old entry points are gone.
  • obc suites check passes. CI is green.
  • The PR reports the total lines removed by the epic.

Depends on

P1 to P6. P7 can follow later.

Activity

  1. added
    enhancementNew feature or request
    maintainabilityReadability, structure, duplication
    infraTooling, scaffold, CI, dev harness
    on Oct 12, 2026
  2. timohueser commented on Oct 13, 2026

    @timohueser
    OwnerAuthor

    P8 progress. Three PRs are merged:

    Next:


    Generated by Claude Code

  3. timohueser commented on Nov 4, 2026

    @timohueser
    OwnerAuthor

    This issue is now the only open item of obc data v2. The epic #2648 is closed, because P1, P2, P3, P4, P5 and P6 are done and P7 is merged into #3000. Items merged here:


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestinfraTooling, scaffold, CI, dev harnessmaintainabilityReadability, structure, duplication

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions