You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by li...@apache.org on 2022/10/24 14:15:00 UTC
[pulsar] branch master updated: [fix][doc] admonitions syntax (#18176)
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 7fee34d52bb [fix][doc] admonitions syntax (#18176)
7fee34d52bb is described below
commit 7fee34d52bb6468c13f004f0fea7f029ab501d55
Author: tison <wa...@gmail.com>
AuthorDate: Mon Oct 24 22:14:51 2022 +0800
[fix][doc] admonitions syntax (#18176)
---
site2/docs/administration-geo.md | 31 +++++++++++++++----------------
1 file changed, 15 insertions(+), 16 deletions(-)
diff --git a/site2/docs/administration-geo.md b/site2/docs/administration-geo.md
index e6ce7c70350..2044b665603 100644
--- a/site2/docs/administration-geo.md
+++ b/site2/docs/administration-geo.md
@@ -59,19 +59,19 @@ Suppose that you have 3 replication clusters: `us-west`, `us-cent`, and `us-east
Run the following command on `us-west`.
-```shell
-bin/pulsar-admin clusters create \
---broker-url pulsar://<DNS-OF-US-EAST>:<PORT> \
---url http://<DNS-OF-US-EAST>:<PORT> \
-us-east
-```
+ ```shell
+ bin/pulsar-admin clusters create \
+ --broker-url pulsar://<DNS-OF-US-EAST>:<PORT> \
+ --url http://<DNS-OF-US-EAST>:<PORT> \
+ us-east
+ ```
- :::tip
+:::tip
- If you want to use a secure connection for a cluster, you can use the flags `--broker-url-secure` and `--url-secure`. For more information, see [pulsar-admin clusters create](/tools/pulsar-admin/).
- Different clusters may have different authentications. You can use the authentication flag `--auth-plugin` and `--auth-parameters` together to set cluster authentication, which overrides `brokerClientAuthenticationPlugin` and `brokerClientAuthenticationParameters` if `authenticationEnabled` sets to `true` in `broker.conf` and `standalone.conf`. For more information, see [authentication and authorization](concepts-authentication.md).
- :::
+:::
2. Configure the connection from `us-west` to `us-cent`.
@@ -100,7 +100,7 @@ bin/pulsar-admin tenants create my-tenant \
To update permissions of an existing tenant, use `update` instead of `create`.
-### Enable geo-replication
+### Enable geo-replication
You can enable geo-replication at **namespace** or **topic** level.
@@ -199,7 +199,7 @@ Given that geo-replication topics exist in multiple regions, directly deleting a
In Pulsar, a topic is automatically deleted when the topic meets the following three conditions:
- no producers or consumers are connected to it;
- no subscriptions to it;
-- no more messages are kept for retention.
+- no more messages are kept for retention.
For geo-replication topics, each region uses a fault-tolerant mechanism to decide when deleting the topic locally is safe.
You can explicitly disable topic garbage collection by setting `brokerDeleteInactiveTopicsEnabled` to `false` in your [broker configuration](reference-configuration.md#broker).
@@ -210,11 +210,11 @@ To delete a geo-replication topic, close all producers and consumers on the topi
Pulsar supports replicated subscriptions, so you can keep the subscription state in sync, within a sub-second timeframe, in the context of a topic that is being asynchronously replicated across multiple geographical regions.
-In case of failover, a consumer can restart consuming from the failure point in a different cluster.
+In case of failover, a consumer can restart consuming from the failure point in a different cluster.
### Enable replicated subscription
-Replicated subscription is disabled by default. You can enable replicated subscriptions when creating a consumer.
+Replicated subscription is disabled by default. You can enable replicated subscriptions when creating a consumer.
```java
Consumer<String> consumer = client.newConsumer(Schema.STRING)
@@ -226,9 +226,9 @@ Consumer<String> consumer = client.newConsumer(Schema.STRING)
### Advantages
- * It is easy to implement the logic.
+ * It is easy to implement the logic.
* You can choose to enable or disable replicated subscription.
- * When you enable it, the overhead is low, and it is easy to configure.
+ * When you enable it, the overhead is low, and it is easy to configure.
* When you disable it, the overhead is zero.
### Limitations
@@ -269,8 +269,7 @@ Using geo-replication to migrate data between clusters is a special use case of
:::note
-* The replication starts from step 4, which means existing messages in your old cluster are not replicated.
+* The replication starts from step 4, which means existing messages in your old cluster are not replicated.
* If you have some older messages to migrate, you can pre-create the replication subscriptions for each topic and set it at the earliest position by using `pulsar-admin topics create-subscription -s pulsar.repl.new-cluster -m earliest <topic>`.
:::
-