Skip to content

[release/1.15.3] Add cloud stanza documentation#17311

Merged
hanshasselberg merged 3 commits intomainfrom
jer/cloud-docs
May 15, 2023
Merged

[release/1.15.3] Add cloud stanza documentation#17311
hanshasselberg merged 3 commits intomainfrom
jer/cloud-docs

Conversation

@jjacobson93
Copy link
Contributor

Description

This PR adds documentation for the HCP cloud stanza.

PR Checklist

  • updated test coverage
  • external facing docs updated
  • appropriate backport labels added
  • not a security concern

@jjacobson93 jjacobson93 requested a review from a team as a code owner May 11, 2023 18:42
@github-actions github-actions bot added the type/docs Documentation needs to be created/updated/clarified label May 11, 2023
Copy link
Member

@hanshasselberg hanshasselberg left a comment

Choose a reason for hiding this comment

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

left two comments.


- `cloud` This object specifies settings for connecting to HCP. This was added in Consul 1.14

- `client_id` The OAuth2 client ID for authentication with HCP
Copy link
Member

Choose a reason for hiding this comment

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

Should we note that there is an env variable for client_id that can be used instead. Same goes for secret, hostname, auth_url and scada_address.


- `resource_id` The HCP resource identifier

- `hostname` (optional) The HCP hostname
Copy link
Member

Choose a reason for hiding this comment

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

Wonder if we should document hostname, auth_url and scada_address because they are only for internal use.

Copy link
Member

Choose a reason for hiding this comment

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

I would vote for removing these as distracting. I would wait until someone asks "why aren't these documented?"

@jmurret jmurret added backport/1.14 backport/1.15 This release series is no longer active on CE. Use backport/ent/1.15. labels May 11, 2023
Copy link
Member

@jmurret jmurret left a comment

Choose a reason for hiding this comment

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

Should we clarify the title and description of this section that this is for connecting HCP Consul self-managed clusters (and possibly a sentence about it) vs "HCP"?

Copy link
Member

@hanshasselberg hanshasselberg left a comment

Choose a reason for hiding this comment

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

LGTM

@jjacobson93 jjacobson93 added the pr/no-changelog PR does not need a corresponding .changelog entry label May 12, 2023
@hanshasselberg hanshasselberg merged commit f334fcc into main May 15, 2023
@hanshasselberg hanshasselberg deleted the jer/cloud-docs branch May 15, 2023 10:52
hanshasselberg added a commit that referenced this pull request May 15, 2023
* [CC-4856] Add cloud stanza documentation

* Add environment variables to cloud descriptions

---------

Co-authored-by: Jeremy Jacobson <jeremy.jacobson@hashicorp.com>
hanshasselberg added a commit that referenced this pull request May 15, 2023
* [CC-4856] Add cloud stanza documentation

* Add environment variables to cloud descriptions

* reorder

---------

Co-authored-by: Jeremy Jacobson <jeremy.jacobson@hashicorp.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/1.15 This release series is no longer active on CE. Use backport/ent/1.15. pr/no-changelog PR does not need a corresponding .changelog entry type/docs Documentation needs to be created/updated/clarified

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants