Skip to content
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

Refresh IBM guide to use Kubernetes and Postgres #49018

Open
wants to merge 6 commits into
base: master
Choose a base branch
from

Conversation

hugoShaka
Copy link
Contributor

The v17 test plan showed that the IBM guide was not up-to-date. This PR:

  • refreshes the guide and its screenshots
  • makes the guide a proper step by step guide
  • uses Kubernetes and the teleport-cluster Helm chart
  • uses Postgres instead of etcd (supports audit logs, easier to setup and operate, better UX, better scalability)

Fixes #37059
Fixes #31870
Related to #22611

@hugoShaka hugoShaka added documentation test-plan-problem Issues which have been surfaced by running the manual release test plan labels Nov 14, 2024
@hugoShaka hugoShaka added the no-changelog Indicates that a PR does not require a changelog entry label Nov 14, 2024

Create a release from the chart:
```code
$ helm upgrade --install -n teleport-cluster teleport teleport/teleport-cluster --version "TODO REPLACE ME" -f values.yaml
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Missing palceholder

```
- create a `teleport` user and set its password
```code
# set the same password as the replication user
Copy link
Contributor

Choose a reason for hiding this comment

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

Are we ok with this? We could have a passfile with different passwords for the two users, which would also get rid of the global PGPASSWORD envvar.

Copy link
Contributor

@ptgott ptgott left a comment

Choose a reason for hiding this comment

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

It looks like there's at least one redirect destination assigned to /admin-guides/deploy-a-cluster/deployments/ibm/ that we'll need to change to point to the Helm guide—once that's done, I'll take a look at the preview!

Copy link

🤖 Vercel preview here: https://docs-on2eo06qf-goteleport.vercel.app/docs

@hugoShaka hugoShaka requested a review from ptgott November 20, 2024 20:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation no-changelog Indicates that a PR does not require a changelog entry size/sm test-plan-problem Issues which have been surfaced by running the manual release test plan
Projects
None yet
Development

Successfully merging this pull request may close these issues.

IBM docs are not up-to-date, etcd login fails Running Teleport on IBM Cloud with a PostgreSQL backend
4 participants