refactor(deployment): Standardizes service names to use hyphens instead of underscores for RFC1123 compliance (resolves #1777).

[junhaoliao]

Description

Standardizes service names to use hyphens instead of underscores for RFC1123 compliance
(resolves #1777).

Kubernetes requires RFC1123-compliant names that only allow lowercase alphanumeric characters
and hyphens (not underscores). This PR updates:

• Component name constants in clp_py_utils/clp_config.py
• Docker Compose service hostnames in docker-compose-all.yaml
• Docker Compose runtime hostname in docker-compose.runtime.yaml
• Integration test utilities in clp_mode_utils.py (removed workaround function)

Since Docker Compose uses the service name as the default hostname, redundant explicit
hostname declarations were removed. The only exception is spider-compression-worker,
which requires an explicit hostname of compression-worker for service discovery.

Checklist

• The PR satisfies the contribution guidelines.
• This is a breaking change and that has been indicated in the PR title, OR this isn't a
  breaking change.
• Necessary docs have been updated, OR no docs need to be updated.

Validation performed

Manual inspection:

• Inspected service names in orchestration design docs are using hyphens for consistency with deployment standards
• Verified all component name constants in clp_config.py use hyphens instead of underscores.
• Verified the integration test component lists use the updated hyphenated names.
• Verified the docker-compose-all.yaml file:
  • All service names use hyphens (RFC1123 compliant)
  • Redundant hostname declarations removed (services use service name as default hostname)
  • Only spider-compression-worker retains explicit hostname (compression-worker) as intended
  • All hostname references in commands, health checks, and connection strings updated
• Verified no underscore patterns remain in service names, hostnames, URLs, or paths
  (excluding binary names like /opt/clp/bin/spider_scheduler and Python module paths
  like job_orchestration.scheduler.query.query_scheduler which follow their respective
  naming conventions)

E2E test

Rebuilt the package and container image with task package, then ran a full end-to-end test:

Package startup

./sbin/start-clp.sh

Output confirms hyphenated service names in setup logs:

2025-12-16T04:39:42.105 INFO [controller] Setting up environment for bundling results-cache...
2025-12-16T04:39:42.106 INFO [controller] Setting up environment for compression-scheduler...
2025-12-16T04:39:42.107 INFO [controller] Setting up environment for query-scheduler...
2025-12-16T04:39:42.107 INFO [controller] Setting up environment for compression-worker...
2025-12-16T04:39:42.107 INFO [controller] Setting up environment for query-worker...
2025-12-16T04:39:42.107 INFO [controller] Setting up environment for api-server...
2025-12-16T04:39:42.107 INFO [controller] Setting up environment for garbage-collector...
...
2025-12-16T04:39:54.314 INFO [controller] Started CLP.

All services running with correct names

NAME                                       STATUS
clp-package-b365-api-server-1              Up (healthy)
clp-package-b365-compression-scheduler-1   Up
clp-package-b365-compression-worker-1      Up
clp-package-b365-database-1                Up (healthy)
clp-package-b365-garbage-collector-1       Up
clp-package-b365-query-scheduler-1         Up (healthy)
clp-package-b365-query-worker-1            Up
clp-package-b365-queue-1                   Up (healthy)
clp-package-b365-redis-1                   Up (healthy)
clp-package-b365-reducer-1                 Up
clp-package-b365-results-cache-1           Up (healthy)
clp-package-b365-webui-1                   Up (healthy)

Compression workflow

./sbin/compress.sh --timestamp-key timestamp ~/samples/postgresql.jsonl

2025-12-16T04:45:02.184 INFO [compress] Compression job 3 submitted.
2025-12-16T04:45:04.188 INFO [compress] Compressed 392.84MB into 9.94MB (39.53x). Speed: 199.25MB/s.
2025-12-16T04:45:04.689 INFO [compress] Compression finished.

Service health verification

WebUI (localhost:4000): 200 OK
API Server health: "API server is running"

Package shutdown

./sbin/stop-clp.sh
2025-12-16T04:41:51.690 INFO [controller] Stopped CLP.

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1212888440694337

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}