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

Enhance environment variable criteria in Module Acceptance document by okolawole-ebsco · Pull Request #112 · folio-org/tech-council

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.