| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – Preface</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/</link><description>Recent content in Preface on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>en</language><atom:link href="https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs3-V2: What is Dubbo-go</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/what/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/what/</guid><description> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/dubbogo.png" alt="img"></p> |
| <p>Apache/Dubbo-go (<a href="https://github.com/apache/dubbo-go">github.com/apache/dubbo-go</a>)</p> |
| <p>It is a distributed RPC framework; it is the Go language implementation of Apache/Dubbo. It aims to provide developers with a convenient microservice application development experience.</p> |
| <p>Dubbo-go builds a bridge between Java and Go languages, interconnects with the gRPC/Dubbo/SpringCloud ecology, and relies on the Go language ecology to explore the technical dividends of the cloud-native era.</p></description></item><item><title>Docs3-V2: Concept</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/concept/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/concept/</guid><description/></item><item><title>Docs3-V2: New Features of Dubbo-go 3.0</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/3.0_feature/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/3.0_feature/</guid><description> |
| <p><img src="https://shields.io/github/stars/apache/dubbo-go?style=dark" alt="star"></p> |
| <h2 id="1-triple-protocol">1. Triple protocol</h2> |
| <h3 id="11-overview">1.1 Overview</h3> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/more/3.0_feature/tri.png" alt="img"></p> |
| <ul> |
| <li> |
| <p>communication level</p> |
| <p>The Triple protocol, also known as the Dubbo3 protocol, is an extension protocol based on the HTTP2 + gRPC protocol, adding specific fields and logic, ensuring interoperability with the <strong>native gRPC protocol</strong>. On this basis, Triple&rsquo;s new protocol will more natively support <strong>Dubbo service governance capabilities</strong>. And supports <strong>streaming RPC calls</strong>.</p> |
| <p>In simple terms, it can be understood as Triple = gRPC + Dubbo</p> |
| </li> |
| <li> |
| <p>Serialization</p> |
| <p>The Triple protocol uses an efficient <strong>PB serialization method</strong>, and adds <strong>scalable support</strong> of the serialization protocol on this basis.</p> |
| </li> |
| <li> |
| <p>User development habits:</p> |
| <p>Triple service requires a <strong>predefined .proto file</strong> before development, which is convenient for Go language developers who are accustomed to defining IDL before coding. Different from the Dubbo-go 1.x version that conforms to java programming habits, JavaClassName is defined to describe the interface.</p> |
| </li> |
| <li> |
| <p>Cross-language interoperability:</p> |
| <p>It can realize <strong>cross-language intercommunication</strong> with Dubbo-Java.</p> |
| </li> |
| </ul> |
| <h2 id="2-application-level-service-discovery">2. Application-level service discovery</h2> |
| <h3 id="21-introduction">2.1 Introduction</h3> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/more/3.0_feature/disc.png" alt="img"></p> |
| <p>In the service registration phase, the server instance registers the application-level registration information, mainly including the mapping from the application name to the instance IP, to the registration center. In the service discovery phase, the client instance obtains the IP of the service instance to be requested through the registration center. Entering the service introspection stage, the service introspection process is the process of obtaining interface information through application information. As shown above, there are two modes:</p> |
| <ol> |
| <li>remote mode: Obtain the mapping applied to the interface metadata through the metadata center (such as zk)</li> |
| <li>Local mode: Obtain the mapping from the application to the interface metadata directly through the server (initiate an RPC call for the Metadata Service through the Dubbo protocol)</li> |
| </ol> |
| <p>After service introspection, the client formally initiates a call to the corresponding instance. The most obvious benefit of doing this is to reduce the amount of data in the registry, that is, the registry only saves application-level data.</p> |
| <p>When using the application-level service discovery capability of Dubbo-go 3.0, users can follow the examples and directly configure the service introspection mode and metadata center information in the configuration file, introduce dependencies, and enable application-level service discovery.</p> |
| <h3 id="22-application-level-service-discovery-introduction-article">2.2 Application-level service discovery introduction article</h3> |
| <p><a href="https://baijiahao.baidu.com/s?id=1669266413887039723&amp;wfr=spider&amp;for=pc">Analysis of application-level service discovery</a></p> |
| <h2 id="3-mesh-routing-rules">3. Mesh Routing Rules</h2> |
| <p>User definable routing files:</p> |
| <p>virtual_service.yaml</p> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/more/3.0_feature/virtual_service.png" alt="img"></p> |
| <p>and dist_rule.yml</p> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/more/3.0_feature/dest_rule.png" alt="img"></p> |
| <p>The framework can forward traffic for specific requests according to routing files.</p> |
| <h2 id="4-related-articles">4. Related articles</h2> |
| <p>Alibaba Cloud official introduction article: <a href="https://developer.aliyun.com/article/770964?utm_content=g_1000175535">&ldquo;Dubbo 3.0 - Opening the Next Generation of Cloud Native Microservices&rdquo;</a></p></description></item><item><title>Docs3-V2: Architecture</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/design/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/design/</guid><description/></item><item><title>Docs3-V2: Dubbo-go Samples</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/samples/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/preface/samples/</guid><description> |
| <p>In order to facilitate the use of Dubbogo framework users, we provide the Samples repository for user reference:</p> |
| <p><a href="https://github.com/apache/dubbo-go-samples">[Dubbo-go-samples warehouse address]</a></p> |
| <h2 id="1-examples-contained-in-the-samples-repository">1. Examples contained in the Samples repository</h2> |
| <ul> |
| <li>config-api: use API for configuration initialization</li> |
| <li>configcenter: Use different configuration centers, currently supports three types: zookeeper, apollo, and nacos</li> |
| <li>context: how to use context to pass attachment</li> |
| <li>direct: direct connection mode</li> |
| <li>game: game service example</li> |
| <li>generic: generalized call</li> |
| <li>rpc: RPC call example, including Triple, Dubbo and other protocols and cross-language/gRPC interoperability examples</li> |
| <li>helloworld: RPC call entry example</li> |
| <li>logger: log example</li> |
| <li>registry: Show the docking with different registry centers, including zk, nacos, etcd</li> |
| <li>metrics: data reporting</li> |
| <li>filter: Examples of using provided filters and custom filters</li> |
| <li>registry/servicediscovery: application-level service discovery example</li> |
| <li>router: routing example</li> |
| <li>tracing: link tracing example</li> |
| </ul> |
| <h2 id="2-how-to-run">2. How to run</h2> |
| <p>There are currently three ways to run dubbo-go examples:</p> |
| <ol> |
| <li>Quick start through bash command: start the sample and unit test through a simple command line</li> |
| <li>Start quickly in the IDE, which is also the <strong>recommended</strong> way: In the project &ldquo;.run&rdquo; subdirectory, all example GoLand run configuration files are provided, so users can simply click to run all in the IDE example.</li> |
| <li>Manually configure and run in the IDE: For the purpose of completeness, and in case you do not use GoLand and use other IDEs, here is also a step-by-step configuration guide to help users understand how to configure in the IDE , to run or debug dubbo-go examples.</li> |
| </ol> |
| <h3 id="21-quick-start-via-command-line">2.1 Quick start via command line</h3> |
| <p><em>Preconditions: docker environment is required to be ready</em></p> |
| <p>Below we will use &ldquo;helloworld&rdquo; as an example:</p> |
| <ol> |
| <li> |
| <p><strong>Start the registration center (such as zookeeper)</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>make -f build/Makefile docker-up |
| </span></span></code></pre></div><p>When you see output similar to the following, it means that the zookeeper server is ready to start.</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>&gt; Starting dependency services with ./integrate_test/dockercompose/docker-compose.yml |
| </span></span><span style="display:flex;"><span>Docker Compose is now in the Docker CLI, try <span style="color:#586e75">`</span>docker compose up<span style="color:#586e75">`</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>Creating network <span style="color:#2aa198">&#34;dockercompose_default&#34;</span> with the default driver |
| </span></span><span style="display:flex;"><span>Creating dockercompose_zookeeper_1... <span style="color:#719e07">done</span> |
| </span></span><span style="display:flex;"><span>Creating etcd... <span style="color:#719e07">done</span> |
| </span></span><span style="display:flex;"><span>Creating nacos-standalone... <span style="color:#719e07">done</span> |
| </span></span></code></pre></div><p>If you want to stop the registry, you can do it by running the following command:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>make -f build/Makefile docker-down |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>Start Service Provider</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> helloworld/go-server/cmd |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go run . |
| </span></span></code></pre></div><p>When you see output similar to the following, the service provider is ready to start.</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>2021/10/27 00:33:10 Connected to 127.0.0.1:2181 |
| </span></span><span style="display:flex;"><span>2021/10/27 00:33:10 Authenticated: <span style="color:#268bd2">id</span><span style="color:#719e07">=</span>72057926938066944, <span style="color:#268bd2">timeout</span><span style="color:#719e07">=</span><span style="color:#2aa198">10000</span> |
| </span></span><span style="display:flex;"><span>2021/10/27 00:33:10 Re-submitting <span style="color:#586e75">`</span>0<span style="color:#586e75">`</span> credentials after reconnect |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>Run service caller</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> helloworld/go-client/cmd |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go run . |
| </span></span></code></pre></div><p>When the following information is output, it means that <code>go-client</code> calls <code>go-server</code> successfully.</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>2021-10-27T00:40:44.879+0800 DEBUG triple/dubbo3_client.go:106 TripleClient.Invoke: get <span style="color:#268bd2">reply</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;12345&#34;</span> age:21 |
| </span></span><span style="display:flex;"><span>2021-10-27T00:40:44.879+0800 DEBUG proxy/proxy.go:218 <span style="color:#719e07">[</span>makeDubboCallProxy<span style="color:#719e07">]</span> result: name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;12345&#34;</span> age:21 , err: &lt;nil&gt; |
| </span></span><span style="display:flex;"><span>2021-10-27T00:40:44.879+0800 INFO cmd/client.go:51 client response result: name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;12345&#34;</span> age:21 |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>Integration tests</strong> |
| In addition to showing how to use the functions and features in dubbo-go, this project dubbo-go-samples is also used for integration testing of apache/dubbo-go. Integration tests designed for <code>go-server</code> can be run as follows:</p> |
| <p>Start the server first</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> helloworld/go-server/cmd |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go run . |
| </span></span></code></pre></div><p>Then switch to the single test directory, set the environment variables, and then execute the single test</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> integrate_test/helloworld/tests/integration |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../../../../helloworld/go-client/conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go <span style="color:#b58900">test</span> -v |
| </span></span></code></pre></div><p>When the following information is output, the integration test has passed.</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>&gt; Running integration <span style="color:#b58900">test</span> <span style="color:#719e07">for</span> application go-server |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>--- PASS: TestSayHello <span style="color:#719e07">(</span>0.01s<span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span>PASS |
| </span></span><span style="display:flex;"><span>ok github.com/apache/dubbo-go-samples/integrate_test/helloworld/tests/integration0.119s |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>Close and Cleanup</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>make -f build/Makefile clean docker-down |
| </span></span></code></pre></div></li> |
| </ol> |
| <p>*The following two modes of operation are related to the IDE. Here we take Intellij GoLand as an example to discuss. *</p> |
| <h3 id="22-quick-start-in-ide">2.2 Quick start in IDE</h3> |
| <p>Once you open this project in GoLand, you can find that in the &ldquo;Run Configuration&rdquo; pop-up menu, there are already a series of pre-configured options for running related service providers and callers, for example: &ldquo;helloworld-go-server &quot; and &ldquo;helloworld-go-client&rdquo;.</p> |
| <p>You can select any of these quick start related examples. Of course, before running, it is assumed that the required registry has been started in advance, otherwise the use case will fail. You can choose to start it manually, or use the &ldquo;docker-compose.yml&rdquo; provided in the project to start the docker instance in the registration center.</p> |
| <h3 id="23-manually-run-in-the-ide">2.3. Manually run in the IDE</h3> |
| <p>Take <em>Intellij GoLand</em> as an example here. After opening the dubbo-go-samples project in GoLand, follow the steps below to run/debug this sample:</p> |
| <ol> |
| <li> |
| <p><strong>Start the zookeeper server</strong></p> |
| <p>Open the &ldquo;integrate_test/dockercompose/docker-compose.yml&rdquo; file, and click the ▶︎▶︎ icon in the left gutter column of the editor to run, the &ldquo;Service&rdquo; Tab should pop up and output a text message similar to the following:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>Deploying &#39;Compose: docker&#39;... |
| </span></span><span style="display:flex;"><span>/usr/local/bin/docker-compose -f ...integrate_test/dockercompose/docker-compose.yml up -d |
| </span></span><span style="display:flex;"><span>Creating network &#34;docker_default&#34; with the default driver |
| </span></span><span style="display:flex;"><span>Creating docker_zookeeper_1... |
| </span></span><span style="display:flex;"><span>&#39;Compose: docker&#39; has been deployed successfully. |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>Start Service Provider</strong></p> |
| <p>Open the &ldquo;helloworld/go-server/cmd/server.go&rdquo; file, then click the ▶︎ icon next to the &ldquo;main&rdquo; function in the left gutter column, and select &ldquo;Modify Run Configuration&hellip;&rdquo; from the pop-up menu, And make sure the following configuration is accurate:</p> |
| <ul> |
| <li>Working Directory: Absolute path of &ldquo;helloworld/go-server&rdquo; directory, for example: <em>/home/dubbo-go-samples/helloworld/go-server</em></li> |
| <li>Environment: DUBBO_GO_CONFIG_PATH=&rdquo;../conf/dubbogo.yml&quot;</li> |
| </ul> |
| <p>In this way, the server in the example is ready and ready to run.</p> |
| </li> |
| <li> |
| <p><strong>Run Service Consumer</strong></p> |
| <p>Open the &ldquo;helloworld/go-client/cmd/client.go&rdquo; file, then click the ▶︎ icon next to the &ldquo;main&rdquo; function from the left gutter column, and then select &ldquo;Modify Run Configuration&hellip; &ldquo;, and make sure the following configuration is accurate:</p> |
| <ul> |
| <li>Working Directory: Absolute path of &ldquo;helloworld/go-client&rdquo; directory, for example: <em>/home/dubbo-go-samples/helloworld/go-client</em></li> |
| <li>Environment: DUBBO_GO_CONFIG_PATH=&rdquo;../conf/dubbogo.yml&rdquo;</li> |
| </ul> |
| <p>Then you can run and call the remote service. If the call is successful, there will be the following output:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>[2021-02-03/16:19:30 main.main: client.go: 66] response result: &amp;{A001 Alex Stocks 18 2020-02-04 16:19:30.422 +0800 CST} |
| </span></span></code></pre></div></li> |
| </ol> |
| <p>If you need to debug this example or the dubbo-go framework, you can switch from &ldquo;Run&rdquo; to &ldquo;Debug&rdquo; in the IDE. If you want to end, just click ◼︎ directly.</p></description></item></channel></rss> |
