Tutorial: Quickstart File Store Roundtrip

This tutorial walks through the built-in Quickstart: File Store Roundtrip workflow (quickstart-file-store-roundtrip), which proves an end-to-end deployment lifecycle using a durable hop on local disk.

What you’ll build

The workflow is a simple two-stage system:

echo → file-store (write) → file-store (read) → print

You should see:

• files created under the configured file-store path, and
• events printed to worker logs.

Prerequisites

• A licensed LyftData deployment with the Deployment Manager enabled.
• At least one online worker in a worker group.
• A filesystem path on the worker host that the worker process can read/write.

Step 1: Find the workflow in the Catalog

1. Open Catalog.
2. Filter to Workflows.
3. Search for Quickstart: File Store Roundtrip (or quickstart-file-store-roundtrip).
4. Choose the latest version and click Plan & register.

Step 2: Create the deployment

In the “create deployment” flow:

1. Give the deployment a name (for example file-store-roundtrip-demo).
2. Select a worker group to run it on.
3. If a wizard is shown, set:
   • File-store path: a directory on the worker host (for example /var/lib/lyftdata-worker/file-store).
   • GUID prefix: any short prefix to keep generated file names recognizable.

Step 3: Plan and apply

1. Review the Plan diff (jobs, transports, placement).
2. Click Apply to deploy the generated jobs to the selected worker group.

Step 4: Verify data flow

• Open Workloads and confirm the deployment is running.
• Open Operate → Logs (or worker logs) and confirm events are being printed.
• On the worker host, confirm files appear under your file-store path.

Troubleshooting

• No output in logs: confirm the deployment applied successfully and the worker is online.
• File-store errors: confirm the path exists and the worker process has permissions to write to it.
• TLS/connectivity errors: verify LYFTDATA_URL and certificate trust for the worker group (see Networking & TLS).