From 8f8687ac982eb1bb43250a5263802d656c062d46 Mon Sep 17 00:00:00 2001 From: April M Date: Mon, 15 Sep 2025 13:27:35 -0700 Subject: [PATCH 1/2] revert 147 --- modules/developing/pages/astream-functions.adoc | 10 +++++----- .../pages/clients/spring-produce-consume.adoc | 2 +- modules/developing/pages/configure-pulsar-env.adoc | 2 +- modules/developing/pages/gpt-schema-translator.adoc | 2 +- .../developing/pages/produce-consume-astra-portal.adoc | 2 +- modules/developing/pages/using-curl.adoc | 2 +- .../developing/partials/client-variables-table.adoc | 10 +++++----- modules/getting-started/pages/index.adoc | 10 ++++++---- modules/operations/pages/astream-georeplication.adoc | 2 +- modules/operations/pages/astream-scrape-metrics.adoc | 2 +- modules/operations/pages/astream-token-gen.adoc | 2 +- .../operations/pages/monitoring/stream-audit-logs.adoc | 2 +- modules/operations/pages/private-connectivity.adoc | 2 +- 13 files changed, 26 insertions(+), 24 deletions(-) diff --git a/modules/developing/pages/astream-functions.adoc b/modules/developing/pages/astream-functions.adoc index 91e5392..b953db5 100644 --- a/modules/developing/pages/astream-functions.adoc +++ b/modules/developing/pages/astream-functions.adoc @@ -287,7 +287,7 @@ See <> for more information == Deploy functions in the {astra-ui} -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of the tenant where you want to deploy a function. @@ -393,7 +393,7 @@ Your function should output the result of processing the message. [#controlling-your-function] === Stop and start functions -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of the tenant where you want to manage functions, and then click the *Functions* tab. @@ -403,7 +403,7 @@ Your function should output the result of processing the message. Functions produce logs to help you debug them. -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of the tenant that you want to debug, and then click the *Functions* tab. @@ -415,7 +415,7 @@ If you specified a log topic when deploying your function, function logs also ou === Edit functions -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of the tenant where your function is deployed, and then click the *Functions* tab. @@ -436,7 +436,7 @@ If you need to change any other function settings, you must delete and redeploy Deleting a function is permanent. ==== -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of the tenant where you want to delete a function, and then click the *Functions* tab. diff --git a/modules/developing/pages/clients/spring-produce-consume.adoc b/modules/developing/pages/clients/spring-produce-consume.adoc index 3b0aaca..fa7f56d 100644 --- a/modules/developing/pages/clients/spring-produce-consume.adoc +++ b/modules/developing/pages/clients/spring-produce-consume.adoc @@ -176,7 +176,7 @@ Message received: Hello World ---- ==== -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant, and then verify that the message appears in the specified namespace and topic. diff --git a/modules/developing/pages/configure-pulsar-env.adoc b/modules/developing/pages/configure-pulsar-env.adoc index 122639c..4e37027 100644 --- a/modules/developing/pages/configure-pulsar-env.adoc +++ b/modules/developing/pages/configure-pulsar-env.adoc @@ -44,7 +44,7 @@ The executables in `/bin` use the configurations in `/conf` to run commands. Each tenant you create in {product} comes with its own custom configuration for SSO, endpoints, and so on. You must download the tenant configuration from {product}, and then overwrite the `./conf/client.conf` file. -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant. diff --git a/modules/developing/pages/gpt-schema-translator.adoc b/modules/developing/pages/gpt-schema-translator.adoc index e5872c1..f76d200 100644 --- a/modules/developing/pages/gpt-schema-translator.adoc +++ b/modules/developing/pages/gpt-schema-translator.adoc @@ -23,7 +23,7 @@ The {gpt-schema-translator} is available for the {astra-db} sink connector only. This example uses a JSON schema for a {pulsar-short} topic, and a CQL schema for an {astra-db} table. The {gpt-schema-translator} generates a mapping between the two schemas that the {astra-db} sink connector can use to write data from the {pulsar-short} topic to the {astra-db} table. -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant. diff --git a/modules/developing/pages/produce-consume-astra-portal.adoc b/modules/developing/pages/produce-consume-astra-portal.adoc index 0c5acb2..5283bc2 100644 --- a/modules/developing/pages/produce-consume-astra-portal.adoc +++ b/modules/developing/pages/produce-consume-astra-portal.adoc @@ -9,7 +9,7 @@ The following steps will use the "Try Me" feature of the {astra-ui} to interact == Select the producer and consumer topics -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant. diff --git a/modules/developing/pages/using-curl.adoc b/modules/developing/pages/using-curl.adoc index 240c304..775adf1 100644 --- a/modules/developing/pages/using-curl.adoc +++ b/modules/developing/pages/using-curl.adoc @@ -12,7 +12,7 @@ Depending on the API you use, you need certain information to form HTTP requests == Get the tenant web service URL -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant. diff --git a/modules/developing/partials/client-variables-table.adoc b/modules/developing/partials/client-variables-table.adoc index aa5680e..4f004fe 100644 --- a/modules/developing/partials/client-variables-table.adoc +++ b/modules/developing/partials/client-variables-table.adoc @@ -5,7 +5,7 @@ |`serviceUrl` |The URL to connect to the {pulsar-short} cluster a| -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant, and then click the *Connect* tab. . In the *Tenant Details* section, get the *Broker Service URL*. @@ -16,20 +16,20 @@ a| |`tenantName` |The name of your streaming tenant a| -. In the {astra-ui-link}, click *Streaming tenants*. -. Get the name from the list of tenants. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. +. Get the name from the *Streaming tenants* dashboard. |`namespace` |The segmented area for certain topics in your streaming tenant a| -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant, and then click the *Namespace and Topics* tab. . Choose the target namespace from the list of namespaces. |`topicName` |Topic name (not the full name) a| -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant, and then click the *Namespace and Topics* tab. . Expand the target namespace in the list of namespaces to view the names of the topics within. Do _not_ use the *Full Name*. diff --git a/modules/getting-started/pages/index.adoc b/modules/getting-started/pages/index.adoc index ccc62ec..eee3071 100644 --- a/modules/getting-started/pages/index.adoc +++ b/modules/getting-started/pages/index.adoc @@ -20,7 +20,9 @@ To learn more about the concept of tenancy, see the https://pulsar.apache.org/do You can create a tenant in the {astra-ui} or programmatically. For this quickstart, use the {astra-ui}. -. In the {astra-ui-link}, click **Create tenant**. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. + +. Click *Create tenant*. . Name your streaming tenant something memorable like `my-stream-**RANDOM_UUID**`. All tenant names in {product} must be unique. @@ -30,7 +32,7 @@ All tenant names in {product} must be unique. For this example tenant, the region doesn't really matter. . Click *Create Tenant*. -When the tenant is ready, it appears in the list of tenants in the {astra-ui}. +When the tenant is ready, it appears on the *Streaming tenants* dashboard in the {astra-ui}. == Create a namespace in your tenant @@ -45,7 +47,7 @@ You can create namespaces in the {astra-ui} or programmatically. For this quickstart, use the {astra-ui}. For information about the {pulsar-short} CLI or APIs, see xref:developing:configure-pulsar-env.adoc[] and xref:developing:using-curl.adoc[]. -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant. @@ -70,7 +72,7 @@ To learn more about topics, see the https://pulsar.apache.org/docs/concepts-mess As in the previous steps, you can create topics in the {astra-ui} or programmatically. -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant. diff --git a/modules/operations/pages/astream-georeplication.adoc b/modules/operations/pages/astream-georeplication.adoc index 8b42d4d..3bfbf5e 100644 --- a/modules/operations/pages/astream-georeplication.adoc +++ b/modules/operations/pages/astream-georeplication.adoc @@ -131,7 +131,7 @@ key:[null], properties:[], content:hello-from-pulsar key:[null], properties:[], content:hello-from-pulsar ---- -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant, and then click the **Namespaces and Topics** tab. diff --git a/modules/operations/pages/astream-scrape-metrics.adoc b/modules/operations/pages/astream-scrape-metrics.adoc index ff5056b..3c08e81 100644 --- a/modules/operations/pages/astream-scrape-metrics.adoc +++ b/modules/operations/pages/astream-scrape-metrics.adoc @@ -11,7 +11,7 @@ This doc will show you how to scrape an {product} tenant with Prometheus. == Get the configuration file from {product} -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant, and then click the *Connect* tab. diff --git a/modules/operations/pages/astream-token-gen.adoc b/modules/operations/pages/astream-token-gen.adoc index 7ebf6b3..3fd223e 100644 --- a/modules/operations/pages/astream-token-gen.adoc +++ b/modules/operations/pages/astream-token-gen.adoc @@ -19,7 +19,7 @@ You need a {pulsar-short} JWT for actions related to {pulsar-short} tenants, nam You can generate, copy, or delete {product} {pulsar-short} tokens for each of your {product} tenants: -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of your tenant where you want to manage tokens. diff --git a/modules/operations/pages/monitoring/stream-audit-logs.adoc b/modules/operations/pages/monitoring/stream-audit-logs.adoc index 9143569..ed0d7db 100644 --- a/modules/operations/pages/monitoring/stream-audit-logs.adoc +++ b/modules/operations/pages/monitoring/stream-audit-logs.adoc @@ -12,7 +12,7 @@ To enable audit log streaming, you must do one of the following: Audit log streaming requires a streaming tenant in the AWS `us-east-2` region. You can create a new tenant with the xref:astra-streaming:getting-started:index.adoc[{product} quickstart] or use an existing {product} tenant. -. In the {astra-ui-link}, click *Streaming tenants*. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. . Click the name of an existing tenant or create a streaming tenant in AWS `us-east-2`, and then create a namespace and topic in the tenant. + diff --git a/modules/operations/pages/private-connectivity.adoc b/modules/operations/pages/private-connectivity.adoc index fa9d430..89a3460 100644 --- a/modules/operations/pages/private-connectivity.adoc +++ b/modules/operations/pages/private-connectivity.adoc @@ -22,7 +22,7 @@ To use a private link service or private endpoint for {product}, do the followin . Get the name of the {product} clusters where you want to enable private connectivity. + -. In the {astra-ui-link} header, click icon:grip[name="Applications"], select *Streaming*, and then find cluster names in the *Tenants* list. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], select *Streaming*, and then find cluster names on the *Streaming tenants* dashboard. . Get your cloud provider resource identifier: + From 1276f2dc907d9fa32e95d89e08a3f62d94b19fd2 Mon Sep 17 00:00:00 2001 From: "April I. Murphy" <36110273+aimurphy@users.noreply.github.com> Date: Mon, 15 Sep 2025 14:00:51 -0700 Subject: [PATCH 2/2] Apply suggestions from code review --- modules/developing/partials/client-variables-table.adoc | 2 +- modules/getting-started/pages/index.adoc | 5 +++-- modules/operations/pages/private-connectivity.adoc | 2 +- 3 files changed, 5 insertions(+), 4 deletions(-) diff --git a/modules/developing/partials/client-variables-table.adoc b/modules/developing/partials/client-variables-table.adoc index 4f004fe..6a9b178 100644 --- a/modules/developing/partials/client-variables-table.adoc +++ b/modules/developing/partials/client-variables-table.adoc @@ -17,7 +17,7 @@ a| |The name of your streaming tenant a| . In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*. -. Get the name from the *Streaming tenants* dashboard. +. Get the tenant name from the *{product}* dashboard. |`namespace` |The segmented area for certain topics in your streaming tenant diff --git a/modules/getting-started/pages/index.adoc b/modules/getting-started/pages/index.adoc index eee3071..9138581 100644 --- a/modules/getting-started/pages/index.adoc +++ b/modules/getting-started/pages/index.adoc @@ -31,8 +31,9 @@ All tenant names in {product} must be unique. . Choose your preferred cloud provider and region. For this example tenant, the region doesn't really matter. -. Click *Create Tenant*. -When the tenant is ready, it appears on the *Streaming tenants* dashboard in the {astra-ui}. +. Click *Create tenant*. +When the tenant is ready, it appears on the *{product}* dashboard. +Click the tenant's name to inspect and configure it. == Create a namespace in your tenant diff --git a/modules/operations/pages/private-connectivity.adoc b/modules/operations/pages/private-connectivity.adoc index 89a3460..4716cb9 100644 --- a/modules/operations/pages/private-connectivity.adoc +++ b/modules/operations/pages/private-connectivity.adoc @@ -22,7 +22,7 @@ To use a private link service or private endpoint for {product}, do the followin . Get the name of the {product} clusters where you want to enable private connectivity. + -. In the {astra-ui-link} header, click icon:grip[name="Applications"], select *Streaming*, and then find cluster names on the *Streaming tenants* dashboard. +. In the {astra-ui-link} header, click icon:grip[name="Applications"], select *Streaming*, and then find cluster names on the *{product}* dashboard. . Get your cloud provider resource identifier: +