You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by jr...@apache.org on 2022/07/08 14:14:47 UTC

[beam] branch master updated: Update Go BPG xlang documentation to include Java automated service start-up (#22187)

This is an automated email from the ASF dual-hosted git repository.

jrmccluskey pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/beam.git


The following commit(s) were added to refs/heads/master by this push:
     new d44c0440bc9 Update Go BPG xlang documentation to include Java automated service start-up (#22187)
d44c0440bc9 is described below

commit d44c0440bc91f8fd63dcd082c2acf50b40e7af1b
Author: Jack McCluskey <34...@users.noreply.github.com>
AuthorDate: Fri Jul 8 10:14:40 2022 -0400

    Update Go BPG xlang documentation to include Java automated service start-up (#22187)
    
    * Update docs to include auto expansion service in Go
    
    * Correct call-out to not use the "auto" keyword
    
    * Fix whitespace
    
    * Provide reference to UseAutomatedJavaExpansionService()
---
 website/www/site/content/en/documentation/programming-guide.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/website/www/site/content/en/documentation/programming-guide.md b/website/www/site/content/en/documentation/programming-guide.md
index 04817bd86da..cb9d47f9e8c 100644
--- a/website/www/site/content/en/documentation/programming-guide.md
+++ b/website/www/site/content/en/documentation/programming-guide.md
@@ -7066,10 +7066,10 @@ function to access the transform.
 
 **Expansion Services**
 
-The Go SDK does not yet support automatically starting an expansion service. In order to use
-cross-language transforms, you must manually start any necessary expansion services on your local
-machine and ensure they are accessible to your code during pipeline construction; see more at
-[BEAM-12862](https://issues.apache.org/jira/browse/BEAM-12862).
+The Go SDK supports automatically starting Java expansion services if an expansion address is not provided, although this is slower than
+providing a persistent expansion service. Many wrapped Java transforms manage perform this automatically; if you wish to do this manually, use the `xlangx` package's
+[UseAutomatedJavaExpansionService()](https://pkg.go.dev/github.com/apache/beam/sdks/v2@v2.40.0/go/pkg/beam/core/runtime/xlangx#UseAutomatedJavaExpansionService) function. In order to use Python cross-language transforms, you must manually start any necessary expansion
+services on your local machine and ensure they are accessible to your code during pipeline construction.
 
 **Using an SDK wrapper**