Skip to content

Update OpenSSH docs with agentless information#23359

Merged
capnspacehook merged 2 commits intomasterfrom
capnspacehook/agentless-docs
Apr 14, 2023
Merged

Update OpenSSH docs with agentless information#23359
capnspacehook merged 2 commits intomasterfrom
capnspacehook/agentless-docs

Conversation

@capnspacehook
Copy link
Copy Markdown
Contributor

Going forward, agentless nodes are the preferred way to manage OpenSSH nodes, so update the documentation to describe how to add them to a cluster.

SSH agents are not required to connect to agentless nodes, so remove them from this guide so users don't they they still need them.

Supporting RFD: https://github.com/gravitational/teleport/blob/master/rfd/0098-registered-openssh-nodes.md

Updates #21408.

Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx
Comment thread docs/pages/server-access/guides/openssh.mdx
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
@capnspacehook capnspacehook force-pushed the capnspacehook/agentless-docs branch from e143eaf to ea38583 Compare March 24, 2023 22:15
@r0mant r0mant requested a review from jakule March 25, 2023 01:00
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx
Comment thread docs/pages/server-access/guides/openssh.mdx
We've outlined these reasons in [OpenSSH vs Teleport SSH for Servers?](https://goteleport.com/blog/openssh-vs-teleport/)
`teleport` SSH servers have support for multiple features that are incompatible with OpenSSH:

- [Dynamically updating node labels from the output of configured commands](../../management/admin/labels.mdx)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Labels are Teleport specific, so I'm not sure why this would be meaningful to an OpenSSH user. Is the expectation here that OpenSSH users would understand what Teleport labels are?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

My thoughts were having an explicit list of what is and isn't supported with agentless nodes would be useful to set user's expectations, what do you think, is that not necessary?

Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx
@r0mant
Copy link
Copy Markdown
Collaborator

r0mant commented Apr 7, 2023

@capnspacehook Can you address remaining feedback here so we can re-review and get this merged?

@capnspacehook capnspacehook requested a review from ptgott April 11, 2023 19:27
@capnspacehook capnspacehook force-pushed the capnspacehook/agentless-docs branch 2 times, most recently from 6ffab62 to 21b4a55 Compare April 11, 2023 19:29
Copy link
Copy Markdown
Collaborator

@r0mant r0mant left a comment

Choose a reason for hiding this comment

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

@ptgott Can you take another look as well?

Copy link
Copy Markdown
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.

Approved so you're not blocked. Added suggestions that I would recommend incorporating.

Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Comment thread docs/pages/server-access/guides/openssh.mdx Outdated
Going forward, agentless nodes are the preferred way to manage OpenSSH
nodes, so update the documentation to describe how to add them to a
cluster.
@capnspacehook capnspacehook force-pushed the capnspacehook/agentless-docs branch from 21b4a55 to 2f902af Compare April 14, 2023 15:08
@capnspacehook capnspacehook enabled auto-merge April 14, 2023 15:09
@capnspacehook capnspacehook added this pull request to the merge queue Apr 14, 2023
Merged via the queue into master with commit 76a15bd Apr 14, 2023
@capnspacehook capnspacehook deleted the capnspacehook/agentless-docs branch April 14, 2023 16:12
@alexfornuto
Copy link
Copy Markdown
Contributor

I came across this PR while backporting updates that include this content, specifically this Details block.. Are these changes only relevant to v13, or do they apply to previous supported versions?

@zmb3
Copy link
Copy Markdown
Collaborator

zmb3 commented May 16, 2023

Only v13.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants