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

feat: add jaas resource docs #594

Merged
merged 1 commit into from
Sep 26, 2024
Merged

Conversation

kian99
Copy link
Contributor

@kian99 kian99 commented Sep 25, 2024

Description

This PR adds documentation for all JAAS resources. Additionally it simplifies imports so that users don't have to specify the resource type in the import.
Full changes include:

  • Added example plans and import scripts for all JAAS resources.
  • Ran make docs to generate new docs.
  • Updated the description for the "relation" field to point to JAAS docs which contains valid relation values.

Fixes: CSS-10812

Type of change

  • Change existing resource
  • Other (documentation)

@kian99 kian99 force-pushed the jaas-resource-docs branch 4 times, most recently from 6aaed14 to 5f7b9c0 Compare September 25, 2024 19:27
Copy link
Member

@hmlanigan hmlanigan left a comment

Choose a reason for hiding this comment

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

Looks good, 2 minor things.

examples/resources/juju_jaas_access_model/resource.tf Outdated Show resolved Hide resolved
@@ -8,7 +8,8 @@ description: |-

# Juju Provider

The provider can be used to interact with [Juju][0] - an open source orchestration engine by Canonical.
The provider can be used to interact with [Juju][0] - an open source orchestration engine by Canonical.
Additionally, the provider supports interactions with [JAAS][1] - an orchestrator of Juju controllers.
Copy link
Member

Choose a reason for hiding this comment

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

Perhaps this is a good time to update the description in this section: https://github.com/juju/terraform-provider-juju/blob/5f7b9c08783490a6d2cd7b231248ee869cdc1c27/docs/index.md#client-credentials

To include they are used to connect to JAAS? It's not clear in the Authentication section which values will work for JAAS.

Copy link
Contributor Author

@kian99 kian99 Sep 26, 2024

Choose a reason for hiding this comment

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

I've added a note in that section, let me know if I should expand it.

- Simplify imports by eliminating the need for users to provide the resource type
- Add note that client credentials auth is only supported with JAAS
@hmlanigan
Copy link
Member

/merge

@jujubot jujubot merged commit 82e7fd0 into juju:jaas-resources Sep 26, 2024
27 of 31 checks passed
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.

3 participants