2025-11-19 Environment Variable Management IV

1 min

Scribe

@Shelley Doljack followed by @Jeff Gerhard

Reminder:  Please copy/paste the Zoom chat into the notes.  If you miss it, this is saved along with the meeting recording, but having it here has benefits.

Module Evaluation Criteria

ALL

https://github.com/folio-org/tech-council/pull/112

Notes re: draft env var doc:

• What are the tasks coming out of this? Just one Jira ticket for the devops team, @Wayne Schneider will create.

• Is the doc also for edge modules? Yes. Need to state specifically for backend and edge modules.

• Keycloak comment needs to be marked as resolved. Maybe we should make a separate section about 3rd-party prefixes?

• It would be an ever-growing list if we try to document 3rd-party prefixes.

• It could be possible that an env var for keycloak, using KC as prefix, could conflict with a later-to-be-created Keycloak environment var.

• Keycloak has inconsistent naming so we should remove this section from our doc. To avoid confusion, etc.

• SYSTEM_USER is a prefix, so having SYSTEM_USER_USERNAME would be helpful for operators to know that “username” is the data field that is being set and not “name”.

• Special characters comment: standard only supports US/ASCII. Need to reword the formatting rule line.

• Resolved the comment about module descriptors.

• Tooling support: we should add wording about the FOLIO module evaluator.

Notes re: PR specifically:

• @Maccabee Levine comment on the PR: are others in support of this change?

• @Wayne Schneider the PR comment is about the schema definition, so why would we add it to the policy doc? But doesn’t feel strongly about this.

• @Olamide Kolawole maybe we keep the copy/pasted stuff in the PR in order to preserve the versioning of the doc in git. We will also add a link to the policy doc.

• Should the sub-bullet points under the Env Var section be flattened since some would apply and some not?

• We’ll leave the checkboxes/sub-bullet points as they are, not all boxes will be checked when doing the evaluation since some won’t apply to all modules.

• @Olamide Kolawole will finalize the PR and TC will vote on it in the next meeting.

• @Julian Ladisch doesn’t like the overhead of keeping the policy doc in sync with the module_acceptance_criteria.md.

• @Shelley Doljack Why are we doing something different here and not just linking to the policy document like with other things?

• We want the checkboxes so the evaluator can check a box. These are the things we care about, those should be the checkboxes.

• We’ll add a link to the policy doc and slim down the doc to what we care about checking.

Review Decision Record

ALL

https://folio-org.atlassian.net/wiki/x/AoB2Uw

Notes:

• Are there other env var policy docs out in the wild? Olamide did not find any or is not aware of any.

• What should go in the stakeholder section?

  • It should probably be groups and slack channels that we put here instead of individuals.

• my connection went bad for a minute… not sure what happened up to discussion about Rationale.

• Any thoughts regarding the DR?

• @Maccabee Levine should we put a note in the TC channel and more widely to get feedback?

• @Olamide Kolawole we don’t really want to have last minute changes to the doc. Let’s keep this within TC and then after approval, do a round of feedback.

  • Maccabee withdrew comment after this explanation

• Final review and approval of it will be done in the next meeting

NA

Zoom Chat

2025-11-19 09:13:09 From Wayne Schneider to Everyone:
[A-Z0-9]?

2025-11-19 09:13:19 From Julian Ladisch to Everyone:
and _

2025-11-19 09:28:14 From Maccabee Levine to Everyone:
I do suppose we should make sure on the wiki that only TC members can edit pages in that space?

2025-11-19 09:36:55 From Shelley Doljack to Everyone:
My zoom is cutting out or is this affecting others?

2025-11-19 09:37:10 From Maccabee Levine to Everyone:
Replying to "My zoom is cutting out or is this affecting others...":
My connection is ok

2025-11-19 09:37:10 From Wayne Schneider to Everyone:
It is fine for me

2025-11-19 09:39:49 From Wayne Schneider to Everyone:
One more assumption: Okapi dev team will modify the schema for the environment variable descriptor

2025-11-19 09:41:19 From Christie Thomas (she/her) to Everyone:
My apologies, but I need to leave early for an in person meeting.