This is an automated email from the ASF dual-hosted git repository.
liuyu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git
The following commit(s) were added to refs/heads/master by this push:
new f3ffd89 [Doc] add instructions for configuring K8s runtime (#11744)
f3ffd89 is described below
commit f3ffd890d4888e523ce87442e72ce70aab014f04
Author: Anonymitaet <[email protected]>
AuthorDate: Wed Aug 25 08:30:54 2021 +0800
[Doc] add instructions for configuring K8s runtime (#11744)
* [Doc] add instructions for configure K8s runtime
* update
* update
* update
Co-authored-by: Anonymitaet <anonymitaet_hotmail.com>
---
site2/docs/admin-api-overview.md | 2 +-
site2/docs/functions-runtime.md | 4 ++
site2/docs/reference-terminology.md | 2 +-
.../version-2.3.1/reference-terminology.md | 2 +-
.../version-2.6.0/reference-terminology.md | 2 +-
.../version-2.6.1/reference-terminology.md | 2 +-
.../version-2.6.2/reference-terminology.md | 2 +-
.../version-2.6.3/reference-terminology.md | 2 +-
.../version-2.6.4/reference-terminology.md | 2 +-
.../version-2.7.0/admin-api-overview.md | 59 +++++++++++++++++-----
.../version-2.7.0/functions-runtime.md | 4 ++
.../version-2.7.0/reference-terminology.md | 2 +-
.../version-2.7.1/admin-api-overview.md | 2 +-
.../version-2.7.1/functions-runtime.md | 4 ++
.../version-2.7.1/reference-terminology.md | 2 +-
.../version-2.7.2/admin-api-overview.md | 2 +-
.../version-2.7.2/functions-runtime.md | 4 ++
.../version-2.7.2/reference-terminology.md | 2 +-
.../version-2.7.3/admin-api-overview.md | 2 +-
.../version-2.7.3/functions-runtime.md | 4 ++
.../version-2.7.3/reference-terminology.md | 2 +-
.../version-2.8.0/admin-api-overview.md | 2 +-
.../version-2.8.0/functions-runtime.md | 4 ++
.../version-2.8.0/reference-terminology.md | 2 +-
.../version-2.8.1/admin-api-overview.md | 2 +-
.../version-2.8.1/functions-runtime.md | 4 ++
.../version-2.8.1/reference-terminology.md | 2 +-
27 files changed, 92 insertions(+), 33 deletions(-)
diff --git a/site2/docs/admin-api-overview.md b/site2/docs/admin-api-overview.md
index e610e05..252ed34 100644
--- a/site2/docs/admin-api-overview.md
+++ b/site2/docs/admin-api-overview.md
@@ -114,7 +114,7 @@ Kubernetes requires a name that can be used as a DNS
subdomain name as defined i
> **Tip**
>
-> - If you get an error in translating Pulsar object names into Kubernetes
resource labels or want to customize the translating rules, see [customize
Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
>
> - For how to configure Kubernetes runtime, see
> [here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
diff --git a/site2/docs/functions-runtime.md b/site2/docs/functions-runtime.md
index 0cc0fd0..0155f17 100644
--- a/site2/docs/functions-runtime.md
+++ b/site2/docs/functions-runtime.md
@@ -54,6 +54,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git a/site2/docs/reference-terminology.md
b/site2/docs/reference-terminology.md
index 8a31f6c..94a2bac 100644
--- a/site2/docs/reference-terminology.md
+++ b/site2/docs/reference-terminology.md
@@ -78,7 +78,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git
a/site2/website/versioned_docs/version-2.3.1/reference-terminology.md
b/site2/website/versioned_docs/version-2.3.1/reference-terminology.md
index fd6c4c40..2dd3e75 100644
--- a/site2/website/versioned_docs/version-2.3.1/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.3.1/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay)
diff --git
a/site2/website/versioned_docs/version-2.6.0/reference-terminology.md
b/site2/website/versioned_docs/version-2.6.0/reference-terminology.md
index f4eee74..86d7468 100644
--- a/site2/website/versioned_docs/version-2.6.0/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.6.0/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git
a/site2/website/versioned_docs/version-2.6.1/reference-terminology.md
b/site2/website/versioned_docs/version-2.6.1/reference-terminology.md
index aa75925..a64cc26 100644
--- a/site2/website/versioned_docs/version-2.6.1/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.6.1/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git
a/site2/website/versioned_docs/version-2.6.2/reference-terminology.md
b/site2/website/versioned_docs/version-2.6.2/reference-terminology.md
index c4b8fd8..4fc4499 100644
--- a/site2/website/versioned_docs/version-2.6.2/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.6.2/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git
a/site2/website/versioned_docs/version-2.6.3/reference-terminology.md
b/site2/website/versioned_docs/version-2.6.3/reference-terminology.md
index 550bf8e..556aee9 100644
--- a/site2/website/versioned_docs/version-2.6.3/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.6.3/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git
a/site2/website/versioned_docs/version-2.6.4/reference-terminology.md
b/site2/website/versioned_docs/version-2.6.4/reference-terminology.md
index c9bd868..7e011f5 100644
--- a/site2/website/versioned_docs/version-2.6.4/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.6.4/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git a/site2/website/versioned_docs/version-2.7.0/admin-api-overview.md
b/site2/website/versioned_docs/version-2.7.0/admin-api-overview.md
index 9930a84..eabf7ef 100644
--- a/site2/website/versioned_docs/version-2.7.0/admin-api-overview.md
+++ b/site2/website/versioned_docs/version-2.7.0/admin-api-overview.md
@@ -5,27 +5,35 @@ sidebar_label: Overview
original_id: admin-api-overview
---
-The Pulsar admin interface enables you to manage all of the important entities
in a Pulsar [instance](reference-terminology.md#instance), such as
[tenants](reference-terminology.md#tenant),
[topics](reference-terminology.md#topic), and
[namespaces](reference-terminology.md#namespace).
+The Pulsar admin interface enables you to manage all important entities in a
Pulsar instance, such as tenants, topics, and namespaces.
-You can currently interact with the admin interface via:
+You can interact with the admin interface via the following methods.
-- Making HTTP calls against the admin {@inject: rest:REST:/} API provided by
Pulsar [brokers](reference-terminology.md#broker). For some restful apis, they
might be redirected to topic owner brokers for serving
- with [`307 Temporary
Redirect`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/307), hence
the HTTP callers should handle `307 Temporary Redirect`. If you are using
`curl`, you should specify `-L`
- to handle redirections.
-- The `pulsar-admin` CLI tool, which is available in the `bin` folder of your
[Pulsar installation](getting-started-standalone.md):
+> **Tip**
+>
+> **The REST API is the admin interface**. Both the `pulsar-admin` CLI tool
and the Java client use the REST API. If you implement your own admin interface
client, you should use the REST API.
-```shell
-$ bin/pulsar-admin
-```
+- The `pulsar-admin` CLI tool, which is available in the `bin` folder of your
Pulsar installation:
-Full documentation for this tool can be found in the [Pulsar command-line
tools](reference-pulsar-admin.md) doc.
+ ```shell
+ bin/pulsar-admin
+ ```
-- A Java client interface.
+ > **Important**
+ >
+ > For the latest and complete information about `Pulsar admin`, including
commands, flags, descriptions, and more, see [Pulsar admin
doc](https://pulsar.apache.org/tools/pulsar-admin/).
-> #### The REST API is the admin interface
-> Under the hood, both the `pulsar-admin` CLI tool and the Java client both
use the REST API. If you’d like to implement your own admin interface client,
you should use the REST API as well. Full documentation can be found here.
+- HTTP calls, which are made against the admin {@inject: rest:REST:/} API
provided by Pulsar brokers. For some RESTful APIs, they might be redirected to
the owner brokers for serving with [`307 Temporary
Redirect`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/307), hence
the HTTP callers should handle `307 Temporary Redirect`. If you use `curl`
commands, you should specify `-L` to handle redirections.
+
+ > **Important**
+ >
+ > For the latest and complete information about `REST API`, including
parameters, responses, samples, and more, see {@inject: rest:REST:/} API doc.
-In this document, examples from each of the three available interfaces will be
shown.
+- A Java client interface.
+
+ > **Important**
+ >
+ > For the latest and complete information about `Java admin API`, including
classes, methods, descriptions, and more, see [Java admin API
doc](https://pulsar.apache.org/api/admin/).
## Admin setup
@@ -89,3 +97,26 @@ PulsarAdmin admin = PulsarAdmin.builder()
.build();
```
<!--END_DOCUSAURUS_CODE_TABS-->
+
+## How to define Pulsar resource names when running Pulsar in Kubernetes
+If you run Pulsar Functions or connectors on Kubernetes, you need to follow
Kubernetes naming convention to define the names of your Pulsar resources,
whichever admin interface you use.
+
+Kubernetes requires a name that can be used as a DNS subdomain name as defined
in [RFC
1123](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names).
Pulsar supports more legal characters than Kubernetes naming convention. If
you create a Pulsar resource name with special characters that are not
supported by Kubernetes (for example, including colons in a Pulsar namespace
name), Kubernetes runtime translates the Pulsar object names into Kubernetes
resource labels w [...]
+
+- Truncate to 63 characters
+
+- Replace the following characters with dashes (-):
+
+ - Non-alphanumeric characters
+
+ - Underscores (_)
+
+ - Dots (.)
+
+- Replace beginning and ending non-alphanumeric characters with 0
+
+> **Tip**
+>
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+>
+> - For how to configure Kubernetes runtime, see
[here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.7.0/functions-runtime.md
b/site2/website/versioned_docs/version-2.7.0/functions-runtime.md
index 26320a3..e5ba542 100644
--- a/site2/website/versioned_docs/version-2.7.0/functions-runtime.md
+++ b/site2/website/versioned_docs/version-2.7.0/functions-runtime.md
@@ -55,6 +55,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git
a/site2/website/versioned_docs/version-2.7.0/reference-terminology.md
b/site2/website/versioned_docs/version-2.7.0/reference-terminology.md
index 52dd97a..69f658f 100644
--- a/site2/website/versioned_docs/version-2.7.0/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.7.0/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git a/site2/website/versioned_docs/version-2.7.1/admin-api-overview.md
b/site2/website/versioned_docs/version-2.7.1/admin-api-overview.md
index 0b6b85e..b2556c5 100644
--- a/site2/website/versioned_docs/version-2.7.1/admin-api-overview.md
+++ b/site2/website/versioned_docs/version-2.7.1/admin-api-overview.md
@@ -110,6 +110,6 @@ Kubernetes requires a name that can be used as a DNS
subdomain name as defined i
> **Tip**
>
-> - If you get an error in translating Pulsar object names into Kubernetes
resource labels or want to customize the translating rules, see [customize
Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
>
> - For how to configure Kubernetes runtime, see
> [here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
diff --git a/site2/website/versioned_docs/version-2.7.1/functions-runtime.md
b/site2/website/versioned_docs/version-2.7.1/functions-runtime.md
index bb7ad27..930e6b2 100644
--- a/site2/website/versioned_docs/version-2.7.1/functions-runtime.md
+++ b/site2/website/versioned_docs/version-2.7.1/functions-runtime.md
@@ -55,6 +55,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git
a/site2/website/versioned_docs/version-2.7.1/reference-terminology.md
b/site2/website/versioned_docs/version-2.7.1/reference-terminology.md
index 06911ac..878d8b5 100644
--- a/site2/website/versioned_docs/version-2.7.1/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.7.1/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git a/site2/website/versioned_docs/version-2.7.2/admin-api-overview.md
b/site2/website/versioned_docs/version-2.7.2/admin-api-overview.md
index b76610a..6193520 100644
--- a/site2/website/versioned_docs/version-2.7.2/admin-api-overview.md
+++ b/site2/website/versioned_docs/version-2.7.2/admin-api-overview.md
@@ -110,6 +110,6 @@ Kubernetes requires a name that can be used as a DNS
subdomain name as defined i
> **Tip**
>
-> - If you get an error in translating Pulsar object names into Kubernetes
resource labels or want to customize the translating rules, see [customize
Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
>
> - For how to configure Kubernetes runtime, see
> [here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
diff --git a/site2/website/versioned_docs/version-2.7.2/functions-runtime.md
b/site2/website/versioned_docs/version-2.7.2/functions-runtime.md
index 50f2bf2..8ea6128 100644
--- a/site2/website/versioned_docs/version-2.7.2/functions-runtime.md
+++ b/site2/website/versioned_docs/version-2.7.2/functions-runtime.md
@@ -55,6 +55,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git
a/site2/website/versioned_docs/version-2.7.2/reference-terminology.md
b/site2/website/versioned_docs/version-2.7.2/reference-terminology.md
index 0617ad5..9664a42 100644
--- a/site2/website/versioned_docs/version-2.7.2/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.7.2/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git a/site2/website/versioned_docs/version-2.7.3/admin-api-overview.md
b/site2/website/versioned_docs/version-2.7.3/admin-api-overview.md
index 97bdf2c..2e620df 100644
--- a/site2/website/versioned_docs/version-2.7.3/admin-api-overview.md
+++ b/site2/website/versioned_docs/version-2.7.3/admin-api-overview.md
@@ -110,6 +110,6 @@ Kubernetes requires a name that can be used as a DNS
subdomain name as defined i
> **Tip**
>
-> - If you get an error in translating Pulsar object names into Kubernetes
resource labels or want to customize the translating rules, see [customize
Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
>
> - For how to configure Kubernetes runtime, see
> [here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
diff --git a/site2/website/versioned_docs/version-2.7.3/functions-runtime.md
b/site2/website/versioned_docs/version-2.7.3/functions-runtime.md
index def1e55..c395f57 100644
--- a/site2/website/versioned_docs/version-2.7.3/functions-runtime.md
+++ b/site2/website/versioned_docs/version-2.7.3/functions-runtime.md
@@ -55,6 +55,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git
a/site2/website/versioned_docs/version-2.7.3/reference-terminology.md
b/site2/website/versioned_docs/version-2.7.3/reference-terminology.md
index e0b4c96..261d983 100644
--- a/site2/website/versioned_docs/version-2.7.3/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.7.3/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git a/site2/website/versioned_docs/version-2.8.0/admin-api-overview.md
b/site2/website/versioned_docs/version-2.8.0/admin-api-overview.md
index 9e221a8..ffa085b 100644
--- a/site2/website/versioned_docs/version-2.8.0/admin-api-overview.md
+++ b/site2/website/versioned_docs/version-2.8.0/admin-api-overview.md
@@ -104,7 +104,7 @@ Kubernetes requires a name that can be used as a DNS
subdomain name as defined i
> **Tip**
>
-> - If you get an error in translating Pulsar object names into Kubernetes
resource labels or want to customize the translating rules, see [customize
Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
>
> - For how to configure Kubernetes runtime, see
> [here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
diff --git a/site2/website/versioned_docs/version-2.8.0/functions-runtime.md
b/site2/website/versioned_docs/version-2.8.0/functions-runtime.md
index be852b7..3449b55 100644
--- a/site2/website/versioned_docs/version-2.8.0/functions-runtime.md
+++ b/site2/website/versioned_docs/version-2.8.0/functions-runtime.md
@@ -55,6 +55,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git
a/site2/website/versioned_docs/version-2.8.0/reference-terminology.md
b/site2/website/versioned_docs/version-2.8.0/reference-terminology.md
index 4af7306..a1b4eea 100644
--- a/site2/website/versioned_docs/version-2.8.0/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.8.0/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
diff --git a/site2/website/versioned_docs/version-2.8.1/admin-api-overview.md
b/site2/website/versioned_docs/version-2.8.1/admin-api-overview.md
index c6b16cd..e0dbeb3 100644
--- a/site2/website/versioned_docs/version-2.8.1/admin-api-overview.md
+++ b/site2/website/versioned_docs/version-2.8.1/admin-api-overview.md
@@ -104,7 +104,7 @@ Kubernetes requires a name that can be used as a DNS
subdomain name as defined i
> **Tip**
>
-> - If you get an error in translating Pulsar object names into Kubernetes
resource labels or want to customize the translating rules, see [customize
Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
+> - If you get an error in translating Pulsar object names into Kubernetes
resource labels (for example, you may have a naming collision if your Pulsar
object name is too long) or want to customize the translating rules, see
[customize Kubernetes
runtime](https://pulsar.apache.org/docs/en/next/functions-runtime/#customize-kubernetes-runtime).
>
> - For how to configure Kubernetes runtime, see
> [here](https://pulsar.apache.org/docs/en/next/functions-runtime/#configure-kubernetes-runtime).
diff --git a/site2/website/versioned_docs/version-2.8.1/functions-runtime.md
b/site2/website/versioned_docs/version-2.8.1/functions-runtime.md
index e533b7a..9730873 100644
--- a/site2/website/versioned_docs/version-2.8.1/functions-runtime.md
+++ b/site2/website/versioned_docs/version-2.8.1/functions-runtime.md
@@ -55,6 +55,10 @@ The manifests, generated by the functions worker, include a
`StatefulSet`, a `Se
The Kubernetes runtime supports secrets, so you can create a Kubernetes secret
and expose it as an environment variable in the pod. The Kubernetes runtime is
extensible, you can implement classes and customize the way how to generate
Kubernetes manifests, how to pass auth data to pods, and how to integrate
secrets.
+> **Tip**
+>
+> For the rules of translating Pulsar object names into Kubernetes resource
labels, see
[here](admin-api-overview.md#how-to-define-pulsar-resource-names-when-running-pulsar-in-kubernetes).
+
### Basic configuration
It is easy to configure Kubernetes runtime. You can just uncomment the
settings of `kubernetesContainerFactory` in the `functions_worker.yaml` file.
The following is an example.
diff --git
a/site2/website/versioned_docs/version-2.8.1/reference-terminology.md
b/site2/website/versioned_docs/version-2.8.1/reference-terminology.md
index 8edfcd7..dafbcf6 100644
--- a/site2/website/versioned_docs/version-2.8.1/reference-terminology.md
+++ b/site2/website/versioned_docs/version-2.8.1/reference-terminology.md
@@ -79,7 +79,7 @@ if no acknowledgement, then the message will be retained
until it's processed.
#### Negative Acknowledgment (nack)
-When an application fails to process a particular message, it can sends a
"negative ack" to Pulsar
+When an application fails to process a particular message, it can send a
"negative ack" to Pulsar
to signal that the message should be replayed at a later timer. (By default,
failed messages are
replayed after a 1 minute delay). Be aware that negative acknowledgment on
ordered subscription types,
such as Exclusive, Failover and Key_Shared, can cause failed messages to
arrive consumers out of the original order.
