[GitHub] legendtkl opened a new pull request #3048: impove the doc 'Deploying and managing Pulsar Functions'

[GitBox <gi...@apache.org>]

legendtkl opened a new pull request #3048: impove the doc 'Deploying and managing Pulsar Functions'
URL: https://github.com/apache/pulsar/pull/3048
 
 
   Just as discussed with @jiazhai , when follow the doc [Deploying and managing Pulsar Functions](http://pulsar.apache.org/docs/en/functions-deploying/) to do python udf function create and deploy, we will encounter an exception as follow.
   ```bash
   $ bin/pulsar-admin functions create --tenant public --namespace default --name myfunc --py myfunc.py --classname myfunc --input persistent://public/default/in --out persistent://public/default/out
   "Created successfully"
   $ bin/pulsar-admin functions list
   myfunc
   $ bin/pulsar-admin functions trigger --tenant public --namespace default --name myfunc --trigger-value "hello world"
   HTTP 408 Request Timeout
   
   Reason: HTTP 408 Request Timeout
   ```
   
   With the help of @jiazhai , we found the root cause is the python environment is not ready. To be specific, we should install pulsar python client before do python udf function creating and deploy.
   
   Maybe we should point it out clearly in the doc as following, and that is what the PR is doing.
   ```text
   If you're going to deploy and trigger python user-defined functions, you should install [the pulsar python client](http://pulsar.apache.org/docs/en/client-libraries-python/) first.
   ```

----------------------------------------------------------------
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:
users@infra.apache.org


With regards,
Apache Git Services