| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – Service Mesh</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/</link><description>Recent content in Service Mesh on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>en</language><atom:link href="https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs3-V2: Deploy the Istio environment</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/istio/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/istio/</guid><description> |
| <h2 id="1-preparations">1. Preparations</h2> |
| <ul> |
| <li>The docker, helm, and kubectl environments have been installed.</li> |
| <li>dubbo-go cli tools and dependent tools have been installed</li> |
| </ul> |
| <h2 id="2-deploy-the-istio-environment">2. Deploy the Istio environment</h2> |
| <ol> |
| <li>Use helm to install istio base CRD and istiod components. You can also refer to <a href="https://istio.io/">Istio Documentation</a> to install using istioctl.</li> |
| </ol> |
| <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>$ helm repo add istio https://istio-release.storage.googleapis.com/charts |
| </span></span><span style="display:flex;"><span>$ kubectl create namespace istio-system |
| </span></span><span style="display:flex;"><span>$ helm install istio-base istio/base -n istio-system |
| </span></span><span style="display:flex;"><span>$ helm install istiod istio/istiod --namespace istio-system |
| </span></span></code></pre></div><ol start="2"> |
| <li> |
| <p>Delete istio horizontal expansion resource</p> |
| <p>*Currently dubbo-go relies on a single istiod instance for service discovery.</p> |
| </li> |
| </ol> |
| <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>$ kubectl delete hpa istiod -n istio-system |
| </span></span></code></pre></div><p>After the installation is complete, you can see an istiod pod running normally under the istio-system namespace.</p></description></item><item><title>Docs3-V2: Deploy Dubbo-go application in Istio environment</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/deploy/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/deploy/</guid><description> |
| <p>In this chapter, we will use the application template to quickly create a set of Dubbo-go Server and Client applications and deploy them in the Istio cluster; observe, debug and verify that service discovery and invocation are successful.</p> |
| <h2 id="1-preparations">1. Preparations</h2> |
| <ul> |
| <li>The dubbo-go cli tool and dependent tools have been installed, grpc_cli (for local debugging).</li> |
| <li>The docker, helm, and kubectl environments have been installed. (arm machines need to support docker buildx)</li> |
| <li><a href="../istio/">Task [istio environment deployment]</a> completed</li> |
| </ul> |
| <h2 id="2-develop-server-side-dubbo-go-application">2. Develop server-side Dubbo-go application</h2> |
| <h3 id="21-use-dubbogo-cli-to-create-a-project-template">2.1 Use dubbogo-cli to create a project template</h3> |
| <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-plain" data-lang="plain"><span style="display:flex;"><span>$ mkdir mesh-app-server |
| </span></span><span style="display:flex;"><span>$ cd mesh-app-server |
| </span></span><span style="display:flex;"><span>$ dubbogo-cli newApp . |
| </span></span><span style="display:flex;"><span>$ tree . |
| </span></span><span style="display:flex;"><span>. |
| </span></span><span style="display:flex;"><span>├── Makefile |
| </span></span><span style="display:flex;"><span>├── api |
| </span></span><span style="display:flex;"><span>│ └── api.proto |
| </span></span><span style="display:flex;"><span>├──build |
| </span></span><span style="display:flex;"><span>│ └── Dockerfile |
| </span></span><span style="display:flex;"><span>├── chart |
| </span></span><span style="display:flex;"><span>│ ├── app |
| </span></span><span style="display:flex;"><span>│ │ ├── Chart.yaml |
| </span></span><span style="display:flex;"><span>│ │ ├── templates |
| </span></span><span style="display:flex;"><span>│ │ │ ├── _helpers.tpl |
| </span></span><span style="display:flex;"><span>│ │ │ ├── deployment.yaml |
| </span></span><span style="display:flex;"><span>│ │ │ ├── service.yaml |
| </span></span><span style="display:flex;"><span>│ │ │ └── serviceaccount.yaml |
| </span></span><span style="display:flex;"><span>│ │ └── values.yaml |
| </span></span><span style="display:flex;"><span>│ └── nacos_env |
| </span></span><span style="display:flex;"><span>│ ├── Chart.yaml |
| </span></span><span style="display:flex;"><span>│ ├── templates |
| </span></span><span style="display:flex;"><span>│ │ ├── _helpers.tpl |
| </span></span><span style="display:flex;"><span>│ │ ├── deployment.yaml |
| </span></span><span style="display:flex;"><span>│ │ └── service.yaml |
| </span></span><span style="display:flex;"><span>│ └── values.yaml |
| </span></span><span style="display:flex;"><span>├── cmd |
| </span></span><span style="display:flex;"><span>│ └── app.go |
| </span></span><span style="display:flex;"><span>├── conf |
| </span></span><span style="display:flex;"><span>│ └── dubbogo.yaml |
| </span></span><span style="display:flex;"><span>├── go.mod |
| </span></span><span style="display:flex;"><span>├── go.sum |
| </span></span><span style="display:flex;"><span>└── pkg |
| </span></span><span style="display:flex;"><span> └── service |
| </span></span><span style="display:flex;"><span> └── service.go |
| </span></span></code></pre></div><p>The generated project includes several directories:</p> |
| <ul> |
| <li> |
| <p>api: place interface files: proto file and generated pb.go file</p> |
| </li> |
| <li> |
| <p>build: place build related files</p> |
| </li> |
| <li> |
| <p>Chart: place the chart warehouse for publishing, the basic environment chart warehouse: nacos, mesh (under development)</p> |
| </li> |
| <li> |
| <p>cmd: program entry</p> |
| </li> |
| <li> |
| <p>conf: framework configuration</p> |
| </li> |
| <li> |
| <p>pkg/service: RPC service implementation</p> |
| </li> |
| <li> |
| <p>Makefile:</p> |
| </li> |
| <li> |
| <ul> |
| <li>Mirror, Helm installation name:</li> |
| </ul> |
| </li> |
| <li> |
| <ul> |
| <li> |
| <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>IMAGE = $(your_repo)/$(namespace)/$(image_name) |
| </span></span><span style="display:flex;"><span>TAG = 1.0.0 |
| </span></span><span style="display:flex;"><span>HELM_INSTALL_NAME = dubbo-go-app |
| </span></span></code></pre></div></li> |
| </ul> |
| </li> |
| <li> |
| <ul> |
| <li>Provide scripts such as:</li> |
| </ul> |
| </li> |
| <li> |
| <ul> |
| <li> |
| <ul> |
| <li>make build # Package the image and push it</li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li> |
| <p>make buildx-publish # The arm architecture locally packs the amd64 image and pushes it, relying on buildx</p> |
| </li> |
| <li> |
| <p>make deploy # Publish the application through helm</p> |
| </li> |
| <li> |
| <p>make remove # Delete the published helm application</p> |
| </li> |
| <li> |
| <p>make proto-gen # generate pb.go file under api |
| -&hellip;</p> |
| </li> |
| </ul> |
| <h3 id="22-develop-and-deploy-dubbo-go-applications">2.2 Develop and deploy Dubbo-go applications:</h3> |
| <h4 id="developing-applications">Developing Applications</h4> |
| <ul> |
| <li> |
| <p>compile interface</p> |
| <p>Developers need to modify the proto file, and the default interface can be used directly in this task.</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 proto-gen |
| </span></span><span style="display:flex;"><span>protoc --go_out<span style="color:#719e07">=</span>./api --go-triple_out<span style="color:#719e07">=</span>./api ./api/api.proto |
| </span></span></code></pre></div></li> |
| <li> |
| <p>pull dependencies</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>$ go get dubbo.apache.org/dubbo-go/v3@3.0 |
| </span></span><span style="display:flex;"><span>$ make tidy |
| </span></span><span style="display:flex;"><span>go mod tidy |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Write business logic</p> |
| <p>Modify pkg/service/service.go to implement the function, and the version displayed in the returned string is v1.0.0</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-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>GreeterServerImpl) <span style="color:#268bd2">SayHello</span>(ctx context.Context, in <span style="color:#719e07">*</span>api.HelloRequest) (<span style="color:#719e07">*</span>api.User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>api.User{Name: <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> in.Name, Id: <span style="color:#2aa198">&#34;v1.0.0&#34;</span>}, <span style="color:#cb4b16">nil</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Modify the following configuration fields to use the xds protocol as the registration center</p> |
| <p>conf/dubbogo.yaml</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">xds</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: xds |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: istiod.istio-system.svc.cluster.local:15010 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterServerImpl</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: <span style="color:#2aa198">&#34;&#34;</span> <span style="color:#586e75"># read from stub</span> |
| </span></span></code></pre></div><p>At this point, the application development is complete.</p> |
| </li> |
| </ul> |
| <h4 id="configure-build-and-deployment-parameters">Configure build and deployment parameters</h4> |
| <ul> |
| <li> |
| <p>Specify the image to be built:</p> |
| <p>Modify the following fields in the Makefile to specify the address and version of the image to be built.</p> |
| <p>Specify the name that needs to be installed through helm.</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>IMAGE = xxx/dubbo-go-server |
| </span></span><span style="display:flex;"><span>TAG = 1.0.0 |
| </span></span><span style="display:flex;"><span>HELM_INSTALL_NAME = dubbo-go-server-v1 |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Specify the application and image to be deployed:</p> |
| <p>Modify the following fields in chart/app/Chart.yaml, and specify the current application name as <code>dubbo-go-server</code>. When deploying, a service named dubbo-go-server will be created and associated with all versions of the current application.</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: v1 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">name</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">description</span>: dubbo-go-server |
| </span></span></code></pre></div><p>Modify the following fields in chart/app/values.yaml, and specify the image to be deployed and the currently developed application version dubbogoAppVersion as v1.</p> |
| <p>The deployed image needs to be consistent with the image built above. The current application version is used for mesh traffic rule control.</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">image</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">repository</span>: xxx/dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">pullPolicy</span>: Always |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">tag</span>: <span style="color:#2aa198">&#34;1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Dubbo-go-mesh version control labels</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">version</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">labels</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbogoAppVersion</span>: v1 |
| </span></span></code></pre></div><p>At this point, the build parameters and release parameters have been specified, ready to build and deploy.</p> |
| </li> |
| </ul> |
| <h4 id="use-templates-to-build-and-deploy-dubbo-go-applications">Use templates to build and deploy Dubbo-go applications</h4> |
| <ul> |
| <li> |
| <p>Build and push images</p> |
| <p><code>$ make build</code> (locally for amd64 machines)</p> |
| <p>or</p> |
| <p><code>$ make buildx-publish</code> (Local is arm64 machine, depends on docker buildx command)</p> |
| </li> |
| <li> |
| <p>Publish the Dubbo-go application to the cluster</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 deploy |
| </span></span><span style="display:flex;"><span>helm install dubbo-go-server-v1 ./chart/app |
| </span></span><span style="display:flex;"><span>NAME: dubbo-go-server-v1 |
| </span></span><span style="display:flex;"><span>LAST DEPLOYED: Thu Apr <span style="color:#2aa198">7</span> 11:19:42 <span style="color:#2aa198">2022</span> |
| </span></span><span style="display:flex;"><span>NAMESPACE: default |
| </span></span><span style="display:flex;"><span>STATUS: deployed |
| </span></span><span style="display:flex;"><span>REVISION: <span style="color:#2aa198">1</span> |
| </span></span><span style="display:flex;"><span>TEST SUITE: None |
| </span></span><span style="display:flex;"><span>$ helm list |
| </span></span><span style="display:flex;"><span>NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v1 default <span style="color:#2aa198">1</span> 2022-04-07 11:19:42.350553 +0800 CST deployed dubbo-go-server-0.0.1 1.16.0 |
| </span></span></code></pre></div><p>It can be seen that the deployment through helm is successful</p> |
| </li> |
| </ul> |
| <h3 id="23-verify-application">2.3 Verify application</h3> |
| <h4 id="view-resource-deployment">View resource deployment</h4> |
| <p>View the deployed deployment, the version is v1.</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>$ kubectl get deployment |
| </span></span><span style="display:flex;"><span>NAME READY UP-TO-DATE AVAILABLE AGE |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v1 1/1 <span style="color:#2aa198">1</span> <span style="color:#2aa198">1</span> 26s |
| </span></span></code></pre></div><p>View the deployed service.</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>$ kubectl get svc |
| </span></span><span style="display:flex;"><span>NAME TYPE CLUSTER-IP EXTERNAL-IP PORT<span style="color:#719e07">(</span>S<span style="color:#719e07">)</span> AGE |
| </span></span><span style="display:flex;"><span>dubbo-go-server ClusterIP 192.168.216.253 &lt;none&gt; 20000/TCP 70s |
| </span></span></code></pre></div><h4 id="optional-debug-the-deployed-dubbo-go-application-locally">(*Optional) Debug the deployed Dubbo-go application locally</h4> |
| <p>Use kubectl port-forward Dubbo-go to apply locally</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>$ kubectl port-forward svc/dubbo-go-server <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span>Forwarding from 127.0.0.1:20000 -&gt; <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span>Forwarding from <span style="color:#719e07">[</span>::1<span style="color:#719e07">]</span>:20000 -&gt; <span style="color:#2aa198">20000</span> |
| </span></span></code></pre></div><p>Use grpc_cli to debug applications in the cluster, refer to the task <a href="https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/debugging/grpc_cli/">[Use grpc_cli to debug Dubbo-go applications]</a></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>$ grpc_cli ls localhost:20000 -l |
| </span></span><span style="display:flex;"><span>filename: api/api.proto |
| </span></span><span style="display:flex;"><span>package: api; |
| </span></span><span style="display:flex;"><span>service Greeter <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> rpc SayHello<span style="color:#719e07">(</span>api.HelloRequest<span style="color:#719e07">)</span> returns <span style="color:#719e07">(</span>api.User<span style="color:#719e07">)</span> <span style="color:#719e07">{}</span> |
| </span></span><span style="display:flex;"><span> rpc SayHelloStream<span style="color:#719e07">(</span>stream api.HelloRequest<span style="color:#719e07">)</span> returns <span style="color:#719e07">(</span>stream api.User<span style="color:#719e07">)</span> <span style="color:#719e07">{}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><p>Use grpc_cli to initiate a call to test the interface</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>$ grpc_cli call localhost:20000 SayHello <span style="color:#2aa198">&#34;name: &#39;laurence&#39;&#34;</span> |
| </span></span><span style="display:flex;"><span>connecting to localhost:20000 |
| </span></span><span style="display:flex;"><span>name: <span style="color:#2aa198">&#34;Hello Laurence&#34;</span> |
| </span></span><span style="display:flex;"><span>id: <span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>Received trailing metadata from server: |
| </span></span><span style="display:flex;"><span>accept-encoding: identity, gzip |
| </span></span><span style="display:flex;"><span>grpc-accept-encoding : identity,deflate,gzip |
| </span></span><span style="display:flex;"><span>Rpc succeeded with OK status |
| </span></span></code></pre></div><p>So far, we have successfully developed an application and deployed it in the istio cluster.</p> |
| <h2 id="3-develop-client-side-dubbo-go-application">3. Develop client-side Dubbo-go application</h2> |
| <h3 id="31-use-dubbogo-cli-to-create-another-project-template">3.1 Use dubbogo-cli to create another project template</h3> |
| <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>$ dubbogo-cli newApp . |
| </span></span></code></pre></div><h3 id="32-develop-and-deploy-client-dubbo-go-applications">3.2 Develop and deploy client Dubbo-go applications:</h3> |
| <h4 id="write-business-logic">Write business logic</h4> |
| <ul> |
| <li>Modify the main method of cmd/app.go to initiate a call to the downstream interface every second</li> |
| </ul> |
| <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-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span>client <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>api. GreeterClientImpl{} |
| </span></span><span style="display:flex;"><span>config. <span style="color:#268bd2">SetConsumerService</span>(client) |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">Load</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>request <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>api.HelloRequest{ |
| </span></span><span style="display:flex;"><span>Name: <span style="color:#2aa198">&#34;Laurence&#34;</span>, |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">for</span> { |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> rsp, err <span style="color:#719e07">:=</span> client.<span style="color:#268bd2">SayHello</span>(context.<span style="color:#268bd2">Background</span>(), request); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span>{ |
| </span></span><span style="display:flex;"><span>logger.<span style="color:#268bd2">Errorf</span>(<span style="color:#2aa198">&#34;call server error = %s&#34;</span>, err) |
| </span></span><span style="display:flex;"><span>}<span style="color:#719e07">else</span>{ |
| </span></span><span style="display:flex;"><span>logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;call server response = %+v&#34;</span>, rsp) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>time. <span style="color:#268bd2">Sleep</span>(time. Second) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ul> |
| <li> |
| <p>Modify the following configuration file, use the xds protocol as the registration center, and load the client service named GreeterClientImpl.</p> |
| <p>conf/dubbogo.yaml</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">xds</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: xds |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: istiod.istio-system.svc.cluster.local:15010 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">references</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterClientImpl</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: <span style="color:#2aa198">&#34;&#34;</span> <span style="color:#586e75"># read from stub</span> |
| </span></span></code></pre></div><p>At this point, the application development is complete.</p> |
| </li> |
| </ul> |
| <h4 id="configure-build-and-deployment-parameters-1">Configure build and deployment parameters</h4> |
| <ul> |
| <li> |
| <p>Specify the image to be built:</p> |
| <p>Modify the following fields in the Makefile to specify the address and version of the image to be built.</p> |
| <p>Specify the name that needs to be installed through helm.</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>IMAGE=xxx/dubbo-go-client |
| </span></span><span style="display:flex;"><span>TAG = 1.0.0 |
| </span></span><span style="display:flex;"><span>HELM_INSTALL_NAME = dubbo-go-client |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Specify the application and image to be deployed:</p> |
| <p>Modify the following fields in chart/app/Chart.yaml, and specify the current application name as <code>dubbo-go-client</code>. When deploying, a service named dubbo-go-client will be created and associated with all versions of the current application. For a client-only application, you don’t need to create a sevice, and it can be modified by the developer in the template. In this tutorial, we create it by default.</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: v1 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">name</span>: dubbo-go-client |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">description</span>: dubbo-go-client |
| </span></span></code></pre></div><p>Modify the following fields in chart/app/values.yaml, and specify the image to be deployed and the currently developed application version dubbogoAppVersion as v1.</p> |
| <p>The deployed image needs to be consistent with the image built above. The current application version is used for mesh traffic rule control.</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">image</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">repository</span>: xxx/dubbo-go-client |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">pullPolicy</span>: Always |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">tag</span>: <span style="color:#2aa198">&#34;1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Dubbo-go-mesh version control labels</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">version</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">labels</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbogoAppVersion</span>: v1 |
| </span></span></code></pre></div><p>At this point, the build parameters and release parameters have been specified, ready to build and deploy.</p> |
| </li> |
| </ul> |
| <h4 id="use-templates-to-build-and-deploy-dubbo-go-applications-1">Use templates to build and deploy Dubbo-go applications</h4> |
| <ul> |
| <li> |
| <p>Build and push images</p> |
| <p><code>$ make build</code> (locally for amd64 machines)</p> |
| <p>or</p> |
| <p><code>$ make buildx-publish</code> (Local is arm64 machine, depends on docker buildx command)</p> |
| </li> |
| <li> |
| <p>Publish the Dubbo-go Client application to the cluster</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 deploy |
| </span></span><span style="display:flex;"><span>helm install dubbo-go-client ./chart/app |
| </span></span><span style="display:flex;"><span>NAME: dubbo-go-client |
| </span></span><span style="display:flex;"><span>LAST DEPLOYED: Thu Apr <span style="color:#2aa198">7</span> 11:49:55 <span style="color:#2aa198">2022</span> |
| </span></span><span style="display:flex;"><span>NAMESPACE: default |
| </span></span><span style="display:flex;"><span>STATUS: deployed |
| </span></span><span style="display:flex;"><span>REVISION: <span style="color:#2aa198">1</span> |
| </span></span><span style="display:flex;"><span>TEST SUITE: None |
| </span></span><span style="display:flex;"><span>$ helm list |
| </span></span><span style="display:flex;"><span>NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION |
| </span></span><span style="display:flex;"><span>dubbo-go-client default <span style="color:#2aa198">1</span> 2022-04-07 11:49:55.517898 +0800 CST deployed dubbo-go-client-0.0.1 1.16.0 |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v1 default <span style="color:#2aa198">1</span> 2022-04-07 11:23:18.397658 +0800 CST deployed dubbo-go-server-0.0.1 1.16.0 |
| </span></span></code></pre></div><p>It can be seen that the deployment through helm is successful, and there are two applications, Client and Server, in the cluster.</p> |
| </li> |
| </ul> |
| <h3 id="33-verify-application">3.3 Verify application</h3> |
| <h4 id="view-resource-deployment-1">View resource deployment</h4> |
| <p>View the deployed client and server two deployments.</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>$ kubectl get deployment |
| </span></span><span style="display:flex;"><span>NAME READY UP-TO-DATE AVAILABLE AGE |
| </span></span><span style="display:flex;"><span>dubbo-go-client-v1 1/1 <span style="color:#2aa198">1</span> <span style="color:#2aa198">1</span> 22m |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v1 1/1 <span style="color:#2aa198">1</span> <span style="color:#2aa198">1</span> 49m |
| </span></span></code></pre></div><p>Check the client call log</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>$ kubectl get pods | grep client | awk <span style="color:#2aa198">&#39;{print $1}&#39;</span> | xargs kubectl logs |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>2022-04-07T04:13:55.777Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T04:13:56.778Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T04:13:57.779Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T04:13:58.781Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T04:13:59.782Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T04:14:00.784Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T04:14:01.785Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span></code></pre></div><p>The verification call was successful</p> |
| <h2 id="4-summary">4. Summary</h2> |
| <p>The application template provided by dubbogo-cli can conveniently support developers to build, push, and deploy images.</p> |
| <p>In the Istio environment, the server application registers its own service information on Isito, and the client monitors the xds resource and queries the istio debug port for interface-level service discovery. Developers don&rsquo;t need to care about concepts such as service name, host name, and cluster name. They only need to introduce interfaces and initiate calls.</p></description></item><item><title>Docs3-V2: traffic management</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/traffic_management/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/traffic_management/</guid><description> |
| <p>In this section, we will continue the previous task <a href="../deploy/">[Deploy Dubbo-go application in Istio environment]</a>.</p> |
| <p>In the previous task, we deployed a set of Dubbo-go Server and Client applications in the cluster, and verified the success of service discovery and invocation. In this section, we will create a new version of the server-side application. By configuring VirtualService and DestinationRule, routing management and traffic transfer capabilities are realized</p> |
| <h2 id="1-preparations">1. Preparations</h2> |
| <ul> |
| <li>The dubbo-go cli tool and dependent tools have been installed, grpc_cli (for local debugging).</li> |
| <li>The docker, helm, and kubectl environments have been installed. (arm machines need to support docker buildx)</li> |
| <li>Task <a href="../deploy/">[Deploy Dubbo-go application in Istio environment]</a> completed</li> |
| </ul> |
| <h2 id="2-develop-multi-version-dubbo-go-applications">2. Develop multi-version Dubbo-go applications.</h2> |
| <h3 id="21-use-dubbogo-cli-to-create-another-project-template">2.1 Use dubbogo-cli to create another project template</h3> |
| <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>$ dubbogo-cli newApp . |
| </span></span></code></pre></div><h3 id="22-develop-and-deploy-client-dubbo-go-application-v2">2.2 Develop and deploy client Dubbo-go application v2:</h3> |
| <h4 id="write-business-logic">Write business logic</h4> |
| <ul> |
| <li>Modify the implementation method of package/service/service.go, and return the version number as v2.0.0</li> |
| </ul> |
| <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-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>GreeterServerImpl) <span style="color:#268bd2">SayHello</span>(ctx context.Context, in <span style="color:#719e07">*</span>api.HelloRequest) (<span style="color:#719e07">*</span>api.User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>api.User{Name: <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> in.Name, Id: <span style="color:#2aa198">&#34;v2.0.0&#34;</span>}, <span style="color:#cb4b16">nil</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ul> |
| <li> |
| <p>Modify the following configuration file, use the xds protocol as the registration center, and load the service structure named GreeterServerImpl.</p> |
| <p>conf/dubbogo.yaml</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">xds</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: xds |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: istiod.istio-system.svc.cluster.local:15010 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterServerImpl</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: <span style="color:#2aa198">&#34;&#34;</span> <span style="color:#586e75"># read from stub</span> |
| </span></span></code></pre></div><p>At this point, the application development is complete.</p> |
| </li> |
| </ul> |
| <h4 id="configure-build-and-deployment-parameters">Configure build and deployment parameters</h4> |
| <ul> |
| <li> |
| <p>Specify the image to be built:</p> |
| <p>Modify the following fields in the Makefile, specify the address and version of the image to be built, and change the image tag to 2.0.0.</p> |
| <p>Specify the name that needs to be installed through helm.</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>IMAGE = xxx/dubbo-go-server |
| </span></span><span style="display:flex;"><span>TAG = 2.0.0 |
| </span></span><span style="display:flex;"><span>HELM_INSTALL_NAME = dubbo-go-server |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Specify the application and image to be deployed:</p> |
| <p>Modify the following fields in chart/app/Chart.yaml, and specify the current application name as <code>dubbo-go-server</code>. When we created the v1 version of the service, we already had the service of the application. The template will not be created during this deployment service.</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: v1 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">name</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">description</span>: dubbo-go-server |
| </span></span></code></pre></div><p>Modify the following fields in chart/app/values.yaml, specify the image to be deployed as 2.0.0, and the currently developed application version dubbogoAppVersion as v2.</p> |
| <p>The deployed image needs to be consistent with the image built above. The current application version is used for mesh traffic rule control.</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">image</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">repository</span>: xxx/dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">pullPolicy</span>: Always |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">tag</span>: <span style="color:#2aa198">&#34;2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Dubbo-go-mesh version control labels</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">version</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">labels</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbogoAppVersion</span>: v2 |
| </span></span></code></pre></div><p>At this point, the build parameters and release parameters have been specified, ready to build and deploy.</p> |
| </li> |
| </ul> |
| <h4 id="use-templates-to-build-and-deploy-dubbo-go-applications">Use templates to build and deploy Dubbo-go applications</h4> |
| <ul> |
| <li> |
| <p>Build and push images</p> |
| <p><code>$ make build</code> (locally for amd64 machines)</p> |
| <p>or</p> |
| <p><code>$ make buildx-publish</code> (Local is arm64 machine, depends on docker buildx command)</p> |
| </li> |
| <li> |
| <p>Publish Dubbo-go Server v2 to the cluster</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 deploy |
| </span></span><span style="display:flex;"><span>NAME: dubbo-go-server-v2 |
| </span></span><span style="display:flex;"><span>LAST DEPLOYED: Thu Apr <span style="color:#2aa198">7</span> 12:29:28 <span style="color:#2aa198">2022</span> |
| </span></span><span style="display:flex;"><span>NAMESPACE: default |
| </span></span><span style="display:flex;"><span>STATUS: deployed |
| </span></span><span style="display:flex;"><span>REVISION: <span style="color:#2aa198">1</span> |
| </span></span><span style="display:flex;"><span>TEST SUITE: None |
| </span></span><span style="display:flex;"><span>$ helm list |
| </span></span><span style="display:flex;"><span>NAME NAMESPACE REVISION UPDATED STATUS CHART dubbo-go-client default <span style="color:#2aa198">1</span> 2022-04-07 11:49:55.517898 +0800 CST deployed dubbo-go-client-0.0.1 1.16.0 |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v1 default <span style="color:#2aa198">1</span> 2022-04-07 11:23:18.397658 +0800 CST deployed dubbo-go-server-0.0.1 1.16.0 |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v2 default <span style="color:#2aa198">1</span> 2022-04-07 12:29:28.497476 +0800 CST deployed dubbo-go-client-0.0.1 1.16.0 |
| </span></span></code></pre></div><p>It can be seen that the deployment through helm is successful, and there is already a Client application and two versions of Server in the cluster.</p> |
| </li> |
| </ul> |
| <h3 id="23-verify-application">2.3 Verify application</h3> |
| <h4 id="view-resource-deployment">View resource deployment</h4> |
| <p>Looking at the deployed deployment, the server contains two versions.</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>$ kubectl get deployment |
| </span></span><span style="display:flex;"><span>NAME READY UP-TO-DATE AVAILABLE AGE |
| </span></span><span style="display:flex;"><span>dubbo-go-client-v1 1/1 <span style="color:#2aa198">1</span> <span style="color:#2aa198">1</span> 40m |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v2 1/1 <span style="color:#2aa198">1</span> <span style="color:#2aa198">1</span> 77s |
| </span></span><span style="display:flex;"><span>dubbo-go-server-v1 1/1 <span style="color:#2aa198">1</span> <span style="color:#2aa198">1</span> 67m |
| </span></span></code></pre></div><p>View the deployed service. Two versions of the deployment share the same service.</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>$ kubectl get svc |
| </span></span><span style="display:flex;"><span>NAME TYPE CLUSTER-IP EXTERNAL-IP PORT<span style="color:#719e07">(</span>S<span style="color:#719e07">)</span> AGE |
| </span></span><span style="display:flex;"><span>dubbo-go-client ClusterIP 192.168.8.176 &lt;none&gt; 20000/TCP 41m |
| </span></span><span style="display:flex;"><span>dubbo-go-server ClusterIP 192.168.216.253 &lt;none&gt; 20000/TCP 67m |
| </span></span></code></pre></div><p>Check the Client application log to verify that the request is called to two versions of the application.</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>$ kubectl get pods | grep client | awk <span style="color:#2aa198">&#39;{print $1}&#39;</span> | xargs kubectl logs |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:40.384Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:41.386Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:42.388Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:43.389Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:44.390Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:45.392Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:46.393Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:47.394Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:48.396Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:06:49.397Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span></code></pre></div><p>So far, we have successfully developed and deployed multi-version applications.</p> |
| <h2 id="3-configure-request-routing">3. Configure request routing</h2> |
| <h3 id="31-configure-target-rules">3.1 Configure target rules</h3> |
| <p>Execute the following command to create a target rule that subdivides dubbo-go-server into two subsets. v1 and v2</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>$ kubectl apply -f destinationrule.yaml |
| </span></span></code></pre></div><p>destinationrule.yaml content:</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: networking.istio.io/v1alpha3 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">kind</span>: DestinationRule |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">metadata</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">spec</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subsets</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">name</span>: v1 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">labels</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbogoAppVersion</span>: v1 <span style="color:#586e75"># corresponds to the version label specified in chart/app/values.yaml in the application template</span> |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">name</span>: v2 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">labels</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbogoAppVersion</span>: v2 |
| </span></span></code></pre></div><h3 id="32-apply-virtual-service">3.2 Apply Virtual Service</h3> |
| <p>Execute the following command to create a route that routes all traffic to the v1 application.</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>$ kubectl apply -f virtualservice.yaml |
| </span></span></code></pre></div><p>virtualservice.yaml content</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: networking.istio.io/v1alpha3 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">kind</span>: VirtualService |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">metadata</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">spec</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">hosts</span>: |
| </span></span><span style="display:flex;"><span> - dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">http</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">route</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">-destination</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subset</span>: v1 |
| </span></span></code></pre></div><h3 id="33-verify-that-the-routing-takes-effect">3.3 Verify that the routing takes effect</h3> |
| <p>All traffic will go to the v1 app.</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>$ kubectl get pods | grep client | awk <span style="color:#2aa198">&#39;{print $1}&#39;</span> | xargs kubectl logs |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:44.353Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:45.354Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:46.356Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:47.357Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:48.359Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:49.361Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span></code></pre></div><h2 id="4-routing-based-on-user-identity">4. Routing based on user identity</h2> |
| <p>With the above foundation of multi-version application routing, we can implement flexible traffic management through some strategies.</p> |
| <h3 id="41-add-user-identity-for-client-application">4.1 Add user identity for client application</h3> |
| <p>We hope that traffic with the user: admin identifier can experience the new v2 version of the application.</p> |
| <p>Go back to the previously created dubbo-go-client project, modify the main function of cmd/app.go, and add the calling identifier: <code>user: admin</code>.</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-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span>client <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>api. GreeterClientImpl{} |
| </span></span><span style="display:flex;"><span>config. <span style="color:#268bd2">SetConsumerService</span>(client) |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">Load</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>request <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>api.HelloRequest{ |
| </span></span><span style="display:flex;"><span>Name: <span style="color:#2aa198">&#34;Laurence&#34;</span>, |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">for</span> { |
| </span></span><span style="display:flex;"><span>ctx <span style="color:#719e07">:=</span> context. <span style="color:#268bd2">Background</span>() |
| </span></span><span style="display:flex;"><span>ctx = context.<span style="color:#268bd2">WithValue</span>(ctx, constant.AttachmentKey, <span style="color:#268bd2">map</span>[<span style="color:#dc322f">string</span>]<span style="color:#dc322f">string</span>{ |
| </span></span><span style="display:flex;"><span><span style="color:#2aa198">&#34;user&#34;</span>:<span style="color:#2aa198">&#34;admin&#34;</span>, <span style="color:#586e75">// Use the context context to add identity to the call |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>}) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> rsp, err <span style="color:#719e07">:=</span> client.<span style="color:#268bd2">SayHello</span>(ctx, request); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span>{ |
| </span></span><span style="display:flex;"><span>logger.<span style="color:#268bd2">Errorf</span>(<span style="color:#2aa198">&#34;call server error = %s&#34;</span>, err) |
| </span></span><span style="display:flex;"><span>}<span style="color:#719e07">else</span>{ |
| </span></span><span style="display:flex;"><span>logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;call server response = %+v&#34;</span>, rsp) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>time. <span style="color:#268bd2">Sleep</span>(time. Second) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ul> |
| <li> |
| <p>Build and push mirrors, overwriting previous commits. You can also upgrade the released image version.</p> |
| <p><code>$ make build</code> (locally for amd64 machines)</p> |
| <p>or</p> |
| <p><code>$ make buildx-publish</code> (Local is arm64 machine, depends on docker buildx command)</p> |
| </li> |
| <li> |
| <p>Remove dubbo-go-client application</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>$ make remove |
| </span></span><span style="display:flex;"><span>helm uninstall dubbo-go-client |
| </span></span><span style="display:flex;"><span>release &#34;dubbo-go-client&#34; uninstalled |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Republish the app.</p> |
| <p><code>$ make deploy</code></p> |
| <p>After publishing, the verification call is successful because of the previous routing configuration. All traffic goes to the v1 version.</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>$ kubectl get pods | grep client | awk <span style="color:#2aa198">&#39;{print $1}&#39;</span> | xargs kubectl logs |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:44.353Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:45.354Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:46.356Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:47.357Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:48.359Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:40:49.361Z INFO cmd/app.go:29 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span></code></pre></div></li> |
| </ul> |
| <h3 id="42-create-a-route-based-on-user-identity">4.2 Create a route based on user identity</h3> |
| <p>Execute the following command to modify/create a route that routes all traffic with the user: admin identifier in the request header to the v2 version.</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>$ kubectl apply -f virtualservice.yaml |
| </span></span></code></pre></div><p>virtualservice.yaml content</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: networking.istio.io/v1alpha3 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">kind</span>: VirtualService |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">metadata</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">spec</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">hosts</span>: |
| </span></span><span style="display:flex;"><span> - dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">http</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">match</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">headers</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">user</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">exact</span>: admin |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">route</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">-destination</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subset</span>: v2 |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">route</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">-destination</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subset</span>: v1 |
| </span></span></code></pre></div><h3 id="43-verify-that-the-routing-takes-effect">4.3 Verify that the routing takes effect</h3> |
| <p>All traffic will go to the v2 app.</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>$ kubectl get pods | grep client | awk <span style="color:#2aa198">&#39;{print $1}&#39;</span> | xargs kubectl logs |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:18.714Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:19.716Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:20.717Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:21.718Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:22.720Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:23.722Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:52:24.723Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span></code></pre></div><h2 id="5-weight-based-routing">5. Weight-based routing</h2> |
| <h3 id="51-create-weight-based-routing">5.1 Create weight-based routing</h3> |
| <p>Continuing the above tasks, we execute the following commands to modify/create a route that imports 10% of the traffic into the new version of the application for grayscale testing.</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>$ kubectl apply -f virtualservice.yaml |
| </span></span></code></pre></div><p>virtualservice.yaml content</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-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: networking.istio.io/v1alpha3 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">kind</span>: VirtualService |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">metadata</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">spec</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">hosts</span>: |
| </span></span><span style="display:flex;"><span> - dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">http</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">route</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">-destination</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subset</span>: v1 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">weight</span>: <span style="color:#2aa198">90</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">-destination</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: dubbo-go-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subset</span>: v2 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">weight</span>: <span style="color:#2aa198">10</span> |
| </span></span></code></pre></div><h3 id="52-verify-that-the-routing-takes-effect">5.2 Verify that the routing takes effect</h3> |
| <p>A small amount of traffic will go to the v2 release.</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>$ kubectl get pods | grep client | awk <span style="color:#2aa198">&#39;{print $1}&#39;</span> | xargs kubectl logs |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:52.035Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:53.036Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:54.037Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:55.039Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:56.041Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:57.043Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:58.045Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:55:59.047Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:56:00.049Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:56:01.050Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v2.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:56:02.053Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span>2022-04-07T05:56:03.055Z INFO cmd/app.go:35 call server <span style="color:#268bd2">response</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;v1.0.0&#34;</span> |
| </span></span></code></pre></div></description></item><item><title>Docs3-V2: Use Pixiu gateway to access Ingress traffic</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/pixiu/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/pixiu/</guid><description/></item><item><title>Docs3-V2: Proxyless Service Mesh</title><link>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/proxyless_service_mesh/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/golang-sdk/tutorial/governance/service-mesh/proxyless_service_mesh/</guid><description> |
| <h2 id="1-what-is-proxyless-service-mesh-no-proxy-service-mesh-">1. What is Proxyless Service-Mesh (No Proxy Service Mesh) ?</h2> |
| <h3 id="11-brief-analysis-of-service-mesh">1.1 Brief Analysis of Service Mesh</h3> |
| <p>Istio is the most popular open source service mesh today. It consists of a control plane and a data plane. Its architecture is as follows. The picture is taken from <a href="https://istio.io/">istio official website</a></p> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/mesh/proxyless_service_mesh/service-mesh.svg" alt="After using Istio"></p> |
| <p>The control plane located in the lower half of the figure is responsible for the delivery of resources such as configuration, service information, and certificates. The data plane located in the upper part pays attention to the communication traffic between services; the traditional service grid intercepts all business network traffic through proxy, and the proxy needs to perceive the configuration resources issued by the control plane, so as to control the direction of network traffic as required .</p> |
| <p>In the Istiod environment, its control plane is a process called istiod and the network proxy is envoy. istiod obtains service information by monitoring K8S resources such as Service and Endpoint, and sends these resources to the network agent on the data plane through the XDS protocol. Envoy is an independent process that runs with the business application Pod in the form of a sidecar (sidecar). It shares the same host network with the application process and hijacks the network traffic of the business application by modifying the routing table.</p> |
| <p>Service Mesh can solve many problems in microservice scenarios. With the expansion of cluster size and the growth of business complexity, container orchestration solutions based on native k8s will be difficult to cope with, and developers have to face huge service governance challenges. Service Mesh solves this problem very well. It encapsulates service governance requirements in the control plane and proxy, and business developers only need to focus on business logic. After the application is deployed, the operation and maintenance personnel only need to modify the configuration to implement functions such as fault recovery, load balancing, and gray release, which greatly improves the efficiency of R&amp;D and iteration.</p> |
| <p>Istio&rsquo;s sidecar accompanies the entire life cycle of the business application process through container injection, and is non-invasive to the business application, which solves the problems of business application migration, multi-language, and infrastructure coupling. But this also brings problems of high resource consumption and increased request delay.</p> |
| <p>Service provides a good idea for service governance, decoupling infrastructure from business logic, so that application developers only need to focus on business. On the other hand, due to the disadvantages of sidecar, we can consider using sdk instead of sidecar to support the data plane.</p> |
| <h3 id="12-proxyless-service-mesh">1.2 Proxyless Service-Mesh</h3> |
| <p>Agentless service grid is a new concept proposed in recent years. Open source communities such as isito, gRPC, and brpc have all explored and practiced in this direction. The agentless service grid framework is introduced by business applications in the form of SDK, and is responsible for communication and governance between services. The configuration from the control plane is directly sent to the service framework, and the service framework replaces the functions of the above sidecar.</p> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/mesh/proxyless_service_mesh/894c0e52-9d34-4490-b49b-24973ef4aabc.png" alt="img"></p> |
| <p>The main capabilities of the service framework (SDK) can be summarized as the following three points:</p> |
| <ol> |
| <li>Connect to the control plane and monitor configuration resources.</li> |
| <li>Docking applications, providing developers with a convenient interface.</li> |
| <li>Connect to the network and respond to traffic rules according to resource changes.</li> |
| </ol> |
| <h3 id="13-advantages-and-disadvantages-of-proxyless">1.3 Advantages and disadvantages of Proxyless</h3> |
| <p>advantage:</p> |
| <ul> |
| <li>Performance: The network call in the agentless mode is a point-to-point direct communication, and the network delay will be much smaller than that in the agent mode.</li> |
| <li>Stability: The proxyless mode is a single process, with a simple topology, easy debugging, and high stability.</li> |
| <li>Framework integration: There are already many sdk-mode service frameworks on the market, and after switching to mesh, they have the ability to reuse frameworks</li> |
| <li>Resource consumption: no sidecar, low resource consumption</li> |
| </ul> |
| <p>shortcoming:</p> |
| <ul> |
| <li>Language binding: need to develop sdk in multiple languages</li> |
| <li>Low portability: It is impossible to upgrade the infrastructure non-intrusively by switching the form of sidecar.</li> |
| </ul> |
| <p>Generally speaking, the Proxyless architecture is more suitable for use in production environments due to its high performance and high stability.</p> |
| <h2 id="2-dubbo-go-and-proxyless-service-mesh">2. Dubbo-go and Proxyless Service-Mesh</h2> |
| <h3 id="21-design-of-dubbo-go-in-proxyless-service-mesh-scene">2.1 Design of Dubbo-go in Proxyless Service-Mesh scene</h3> |
| <h4 id="service-registration-discovery">Service Registration Discovery</h4> |
| <p>Dubbo-go itself has scalable service registration and discovery capabilities, and we have adapted the implementation of the registration center for the service mesh scenario. Developers can register dubbo-go application information on the istiod control plane. The client application can query the registered interface data to complete the service discovery process.</p> |
| <p><img src="https://dubbo.apache.org/imgs/docs3-v2/golang-sdk/concept/mesh/proxyless_service_mesh/454d1e31-0be3-41fe-97ec-f52673ebf74f.png" alt="img"></p> |
| <ol> |
| <li>Developers use the dubbogo-cli tool to create application templates and publish Deployment / Service to the cluster.</li> |
| <li>The server pulls the full amount of CDS and EDS, compares the local IP, and gets the host name of the current application. And register all the mappings from interface names to host names of this application on Istiod.</li> |
| <li>The client pulls the mapping from the full interface name to the host name from istiod and caches it locally. When a call needs to be made, the local cache is queried, the interface name is converted to a host name, and then pulled to the full endpoint corresponding to the current cluster through CDS and EDS.</li> |
| <li>All endpoints pass through Dubbo-go&rsquo;s built-in Mesh Router to filter out the final subset of endpoints and make requests according to the configured load balancing strategy.</li> |
| </ol> |
| <p>Developers only need to pay attention to the interface throughout the process, and do not need to care about the host name and port information at all. That is, the server developer only needs to implement the pb interface and expose it using the framework; the client developer only needs to introduce the pb interface and initiate a call directly.</p> |
| <h4 id="traffic-management">Traffic management</h4> |
| <p>Dubbo-go has routing capabilities, subscribes to routing configuration from istiod through the xds protocol client, and updates to local routing rules in real time, so as to realize service management. Dubbo-go is compatible with the traffic governance rules of the istio ecology. By configuring Virtual Service and Destination Rule, the marked traffic can be routed to a specified subset, and it can also be used more deeply in scenarios such as grayscale release and flow switching.</p> |
| <h4 id="cloud-native-scaffolding">Cloud Native Scaffolding</h4> |
| <p>dubbogo-cli is a sub-project of the Apache/dubbo-go ecosystem, which provides developers with convenient functions such as application template creation, tool installation, and interface debugging to improve user R&amp;D efficiency.</p> |
| <p>For details, please refer to <a href="https://dubbo.apache.org/en/docs3-v2/golang-sdk/refer/use_dubbogo_cli/">[dubbogo-cli tool]</a></p> |
| <h2 id="3-advantages-of-dubbo-go-mesh">3. Advantages of Dubbo-go-Mesh</h2> |
| <h3 id="31-interface-level-service-discovery">3.1 Interface-level service discovery</h3> |
| <p>The previous article introduced the advantages of discovery through interface-level service registration, that is, developers do not need to care about downstream host names and port numbers, but only need to introduce interface stubs, or implement interfaces, and start them through the framework.</p> |
| <h3 id="32-high-performance">3.2 High Performance</h3> |
| <p>We deployed the istio environment in the k8s cluster, and tested the gRPC service call in sidecar mode and the dubbo-go application service call in Proxyless mode. It is found that proxyless is an order of magnitude less than sidecar mode in terms of request time consumption, that is, the performance is improved by about ten times.</p> |
| <h3 id="33-cross-ecology">3.3 Cross-ecology</h3> |
| <p>Dubbo-go is a service framework that spans multiple ecosystems.</p> |
| <ul> |
| <li> |
| <p>mesh ecology</p> |
| <p>Developers can use Dubbo-go for application development while using the powerful capabilities provided by the istio ecosystem.</p> |
| </li> |
| <li> |
| <p>gRPC ecology</p> |
| <ul> |
| <li>Dubbo-go supports interoperability with gRPC services, HTTP2 protocol stack.</li> |
| <li>Dubbo-go uses pb serialization by default, high performance.</li> |
| </ul> |
| </li> |
| <li> |
| <p>Dubbo Ecology</p> |
| <ul> |
| <li>Multilingual advantage, can realize go-java application intercommunication.</li> |
| <li>Compatible with pixiu gateway, convenient for service exposure and protocol conversion.</li> |
| <li>Use Dubbo-go ecological components.</li> |
| </ul> |
| </li> |
| </ul></description></item></channel></rss> |
