Skip to content

docs: describe operational readiness #12723

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Mar 25, 2024
Merged

Conversation

mtojek
Copy link
Member

@mtojek mtojek commented Mar 22, 2024

Fixes: #12426

This PR extends Reference Architectures with a paragraph about the operational readiness of Coder deployment. Feel free to add more ideas to the checklist.

Extra changes:

  • do no use parallel mode while running make gen and make build/coder_docs.... It fails with coderd/rbac/object_gen.go:1:1: syntax error: package statement must be first.

@mtojek mtojek requested review from mafredri and johnstcn March 22, 2024 16:00
@mtojek mtojek marked this pull request as ready for review March 22, 2024 16:01
1. Incorporate [support links](../appearance.md#support-links) into internal
documentation accessible from the user context menu. Ensure that hyperlinks
are valid and lead to up-to-date materials.
1. Encourage the use of `coder support bundle` to allow workspace users to
Copy link
Member

Choose a reason for hiding this comment

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

coder support bundle can only be used by administrators -- additionally, the command is currently hidden and will be un-hidden closer to the next release.

Copy link
Member Author

Choose a reason for hiding this comment

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

I guess that this is coming now 👍

@mtojek mtojek requested a review from johnstcn March 25, 2024 13:20
@mtojek mtojek force-pushed the 12426-operational-excellence branch from 693dbe2 to d8c5708 Compare March 25, 2024 13:26
Comment on lines +205 to +207
# no `-j` flag as `make` fails with:
# coderd/rbac/object_gen.go:1:1: syntax error: package statement must be first
run: "make --output-sync -B gen"
Copy link
Member

Choose a reason for hiding this comment

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

👍 I think this is fine for now but ideally we should figure out why this happens. Maybe file a follow-up issue?

@mtojek mtojek merged commit 1e0bbd5 into main Mar 25, 2024
@mtojek mtojek deleted the 12426-operational-excellence branch March 25, 2024 16:10
@github-actions github-actions bot locked and limited conversation to collaborators Mar 25, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

docs: Build public-facing documentation for Reference Architectures
2 participants