jerrypeng commented on a change in pull request #2275: [website] improve pulsar connector documentation URL: https://github.com/apache/incubator-pulsar/pull/2275#discussion_r207024843
########## File path: site2/docs/io-managing.md ########## @@ -0,0 +1,115 @@ +--- +id: io-managing +title: Managing Connectors +sidebar_label: Managing Connectors +--- + +This section describes how to manage Pulsar IO connectors in a Pulsar cluster. You will learn how to: + +- Deploy builtin connectors +- Monitor and update running connectors with Pulsar Admin CLI +- Deploy customized connectors +- Upgrade a connector + +## Using Builtin Connectors + +Pulsar bundles several [builtin connectors](io-overview.md#working-with-connectors) that should be used for moving data in and out +of commonly used systems such as databases, messaging systems. Getting set up to use these builtin connectors is simple. You can follow +the [instructions](getting-started-standalone.md#installing-builtin-connectors) on installing builtin connectors. After setup, all +the builtin connectors will be automatically discovered by Pulsar brokers (or function-workers), so no additional installation steps are +required. + +## Configuring Connectors + +Configuring Pulsar IO connectors is straightforward. What you need to do is to provide a yaml configuration file when your [run connectors](#running-connectors). +The yaml configuration file basically tells Pulsar where to locate the sources and sinks and how to connect those sources and sinks with Pulsar topics. + +Below is an example yaml configuration file for Cassandra Sink: + +```shell +tenant: public +namespace: default +name: cassandra-test-sink +... +# cassandra specific config +configs: + roots: "localhost:9042" + keyspace: "pulsar_test_keyspace" + columnFamily: "pulsar_test_table" + keyname: "key" + columnName: "col" +``` + +The example yaml basically tells Pulsar which Cassandra cluster to connect, what is the `keyspace` and `columnFamily` to be used in Cassandra for collecting data, +and how to map a Pulsar message into Cassandra table key and columns. + +For details, consult the documentation for [individual connectors](io-overview.md#working-with-connectors). + +## Running Connectors + +Pulsar connectors can be managed using the [`source`](reference-pulsar-admin.md#source) and [`sink`](reference-pulsar-admin.md#sink) commands of the [`pulsar-admin`](reference-pulsar-admin.md) CLI tool. + +### Running sources + +You can use the [`create`](reference-pulsar-admin.md#source-create) + +You can submit a sink to be run in an existing Pulsar cluster using a command of this form: Review comment: Think should be for sources ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
