Skip to content

Conversation

kfindeisen
Copy link
Member

This PR updates the docs to reflect current conventions for managing APDB configs with both Postgres and Cassandra.

Keyspaces like pp_apdb_latiss are now reserved for production; development
spaces are suffixed with _dev.
@kfindeisen kfindeisen requested a review from hsinfang June 19, 2024 01:40
password: PASSWORD
# Workaround for list-cassandra not having keyspace-agnostic credentials, MUST go after all other entries
- url: cassandra://sdfk8sk001.sdf.slac.stanford.edu:9042/*
username: ANY_CASSANDRA_ACCOUNT
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean ANY_CASSANDRA_ACCOUNT literally here and not apdb?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can use apdb, apdb-prod, or anything else, so long as it's a valid account. How to express that?

Having all keyspaces use the apdb credentials is potentially
problematic. The revised example leaves room for prod APDB configs
later, even though those are outside the scope of the Playbook.
Adding comments to the file makes it easier to understand. Users should
not be using the service accounts instead of the developer account.
This allows developers to use db-auth-only setups if they don't need to
work with Postgres.
We want labels for all our APDBs for ease of analysis and management,
even if Prompt Processing itself can't read the index.
Fixed some typos and removed the dashboard link, which is
now in Slack with the others.
--init-only guarantees that dataset types are registered, and it's much
faster than actually running the pipeline.
This message is directed towards new users, who might not know what to
do when they want to run, say, 10 visits.
@kfindeisen kfindeisen merged commit a0fa9a1 into main Jun 20, 2024
@kfindeisen kfindeisen deleted the tickets/DM-44844 branch June 20, 2024 17:47
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.

2 participants