Skip to content

Commit 277d20e

Browse files
authored
add astra role attributes (#41)
1 parent 57a2e88 commit 277d20e

4 files changed

Lines changed: 8 additions & 6 deletions

File tree

antora.yml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,4 +29,8 @@ asciidoc:
2929
cql: 'Cassandra Query Language (CQL)'
3030
cql-shell: 'CQL shell'
3131
cql-console: 'CQL console'
32-
pulsar-short: 'Pulsar'
32+
pulsar-short: 'Pulsar'
33+
34+
# Astra role attributes (compare with astra-vector-docs antora.yml)
35+
organization-administrator-role: 'xref:astra-db-serverless:administration:rbac.adoc#organization-administrator-role[Organization Administrator]'
36+
database-administrator-role: 'xref:astra-db-serverless:administration:rbac.adoc#database-administrator-role[Database Administrator]'

in-progress/administration.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ astra user invite **USER_EMAIL**
131131

132132
[IMPORTANT]
133133
====
134-
If you don't specify a role when inviting a user, the user is automatically assigned the default role of `Database Administrator`.
134+
If you don't specify a role when inviting a user, the user is automatically assigned the default role of {database-administrator-role}.
135135
====
136136

137137
=== `user invite` options
@@ -200,7 +200,7 @@ Replace the following:
200200
* `**ROLE**`: The name or ID of the role you want to assign to the user.
201201
To get a list of the available roles in your organization, see <<list-roles>>.
202202

203-
For example, to invite a user with the `Organization Administrator` role:
203+
For example, to invite a user with the {organization-administrator-role} role:
204204

205205
[source,bash]
206206
----

in-progress/quickstart-databases.adoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
// Writer's note: This page contains a selection of content that was deleted from the Astra Serverless docs. We should retain relevant content reformat it for Astra CLI 1.0.
22
= Manage databases with the {product}
33
:navtitle: Quickstart for databases
4-
:organization-administrator-role: pass:q[xref:astra-db-serverless:administration:rbac.adoc#organization-administrator-role[*Organization Administrator*]]
5-
:database-administrator-role: pass:q[xref:astra-db-serverless:administration:rbac.adoc#database-administrator-role[*Database Administrator*]]
64

75
You can use the {product} to perform administrative operations on your {astra-db} databases and keyspaces.
86

modules/ROOT/pages/manage-cli.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ xref:astra-db-serverless:administration:manage-application-tokens.adoc#org-token
2424
[TIP]
2525
====
2626
If this is your first time using the {product}, {company} recommends that you connect to a non-production organization first.
27-
That way, you can assign your application token a more expansive role, such as *Organization Administrator*, so that you can try out all of the {product}'s features without putting production data at risk.
27+
That way, you can assign your application token a more expansive role, such as {organization-administrator-role}, so that you can try out all of the {product}'s features without putting production data at risk.
2828
2929
If you're using the {product} in production, {company} strongly recommends that you follow the principle of least privilege: Make sure your application token's role provides only the minimum required permissions.
3030
For example, don't grant an administrator-level role to a token that won't be used to execute those types of commands.

0 commit comments

Comments
 (0)