Skip to content

Add documentation for OpenShift #470

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 22 commits into from
Jul 14, 2021
Merged

Add documentation for OpenShift #470

merged 22 commits into from
Jul 14, 2021

Conversation

Emyrk
Copy link
Member

@Emyrk Emyrk commented Jul 7, 2021

greyscaled and others added 4 commits July 6, 2021 17:16
* hotfix: Templates language [ch14098]

This implements task 2 (documentation) for normalizing the language
around workspace templates.

Details:

* Rename workspaces-as-code directory to workspace-templates
* Replace WAC and Workspaces as code with workspace templates

Co-authored-by: Katie Horne <katie@coder.com>
*Total -- 195.86kb -> 172.63kb (11.86%)

/assets/workspaces/workspace-overview.png -- 134.26kb -> 116.30kb (13.37%)
/assets/workspaces/status-chip.png -- 61.60kb -> 56.33kb (8.56%)

Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com>

Co-authored-by: ImgBotApp <ImgBotHelp@gmail.com>
@github-actions
Copy link
Contributor

github-actions bot commented Jul 7, 2021

✨ Coder.com for PR #470 deployed! It will be updated on every commit.

@jawnsy
Copy link
Contributor

jawnsy commented Jul 9, 2021

[ch3540]

@shortcut-integration
Copy link

bpmct and others added 4 commits July 9, 2021 21:42
Bumps [husky](https://github.com/typicode/husky) from 7.0.0 to 7.0.1.
- [Release notes](https://github.com/typicode/husky/releases)
- [Commits](typicode/husky@v7.0.0...v7.0.1)

---
updated-dependencies:
- dependency-name: husky
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [@types/minimist](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/minimist) from 1.2.1 to 1.2.2.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/minimist)

---
updated-dependencies:
- dependency-name: "@types/minimist"
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
@jawnsy jawnsy changed the title [WIP] Begin Openshift docs [WIP] Add documentation for OpenShift Jul 10, 2021
Katie Horne and others added 4 commits July 12, 2021 09:03
chore: document special case re: GitHub and callback/dev URLs

Co-authored-by: Ben Potter <me@bpmct.net>
* Open pull requests for major version updates for GitHub Actions
* Ignore version updates for Node.js types
Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 12.20.15 to 12.20.16.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Recommend that users track supported Kubernetes versions, and remove
the reference to version 1.13.

Co-authored-by: Katie Horne <katie@coder.com>
Emyrk and others added 4 commits July 13, 2021 01:35
@jawnsy
Copy link
Contributor

jawnsy commented Jul 13, 2021

@Emyrk I can't tag you as reviewer since you opened the PR, please take a look at these changes, and then we'll ask Katie to review.

Comment on lines 17 to 20
## Prerequisites

- An OpenShift cluster with a Project (Kubernetes namespace) for Coder
- OpenShift command-line tools (`oc` and `kubectl`)
Copy link
Member Author

Choose a reason for hiding this comment

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

Should we add Postgres here? Do we need to include docs on how to spin up postgres on openshift?

Copy link
Contributor

Choose a reason for hiding this comment

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

This is a great point -- Our other guides don't mention PostgreSQL, I think we just expect users to find their own 🤔

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 am ok with that personally, if anyone ends up needing those docs, I'm sure we will hear about it.

Maybe we should mention it in the prereqs though?

Copy link
Contributor

Choose a reason for hiding this comment

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

Well, if we mention it for OpenShift, we should mention it for Azure/EKS/GKE, too, for consistency... and then I suppose it's best to do that as a separate PR

@jawnsy jawnsy requested a review from khorne3 July 13, 2021 19:23
@jawnsy
Copy link
Contributor

jawnsy commented Jul 13, 2021

@khorne3 I think this is ready for your review now. This requires some changes to our Helm chart that are only available after 1.21 is released, so I'm not sure exactly how to handle this - maybe as a pull request into a release branch? Can you advise?

@jawnsy jawnsy marked this pull request as ready for review July 13, 2021 19:24
@jawnsy jawnsy changed the title [WIP] Add documentation for OpenShift Add documentation for OpenShift Jul 13, 2021
@khorne3
Copy link
Contributor

khorne3 commented Jul 13, 2021

@jawnsy I started a 1.21 branch so we can merge this into that, instead of main, when ready

@khorne3
Copy link
Contributor

khorne3 commented Jul 13, 2021

@Emyrk just some clarification questions: to use Openshift, they should:

  1. Modify pod and container security contexts
  2. Choose between Option 1 (add service account) and Option 2 (build images)

where both steps are required?

@jawnsy jawnsy changed the base branch from main to release-1.21 July 13, 2021 22:11
Emyrk and others added 4 commits July 13, 2021 22:12
@jawnsy
Copy link
Contributor

jawnsy commented Jul 13, 2021

@khorne3 Yup, your understanding is correct!

I've re-targeted this change to the release branch and re-based, so everything should be ready to go now

@jawnsy jawnsy merged commit 4f2b6d0 into release-1.21 Jul 14, 2021
@jawnsy jawnsy deleted the openshift branch July 14, 2021 16:55
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.

6 participants