| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – Mesh Manual</title><link>https://dubbo.apache.org/en/docs3-v2/java-sdk/reference-manual/mesh/</link><description>Recent content in Mesh Manual on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>en</language><atom:link href="https://dubbo.apache.org/en/docs3-v2/java-sdk/reference-manual/mesh/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs3-V2: Debug Reference Documentation</title><link>https://dubbo.apache.org/en/docs3-v2/java-sdk/reference-manual/mesh/mesh/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs3-v2/java-sdk/reference-manual/mesh/mesh/</guid><description> |
| <h2 id="pre-environment-preparation">Pre-environment preparation</h2> |
| <ul> |
| <li>docker environment</li> |
| <li>kubernetes environment (docker desktop is recommended, with a graphical interface, and a small Kubernetes environment is embedded, and the following demonstration is also based on docker desktop)</li> |
| <li>istio environment</li> |
| <li>dubbo-samples code, the master branch is fine</li> |
| <li>dubbo version &gt;= 3.1.0 |
| Build a Kubernetes environment |
| Currently Dubbo only supports Mesh deployment in the Kubernetes environment, so you need to set up the Kubernetes environment before running and starting this example. (It is recommended to use docker desktop to build, and you can run a kubernetes environment directly) |
| <a href="https://docs.docker.com/desktop/install/mac-install/">https://docs.docker.com/desktop/install/mac-install/</a></li> |
| </ul> |
| <h2 id="build-kubernetes-environment">Build Kubernetes environment</h2> |
| <p>Currently Dubbo only supports Mesh deployment in the Kubernetes environment, so you need to set up the Kubernetes environment before running and starting this example. (It is recommended to use docker desktop to build, and you can run a kubernetes environment directly) |
| <a href="https://docs.docker.com/desktop/install/mac-install/">https://docs.docker.com/desktop/install/mac-install/</a></p> |
| <h2 id="build-kubernetes-environment-1">Build Kubernetes environment</h2> |
| <p>Build the Istio environment reference document: |
| Istio installation documentation (<a href="https://istio.io/latest/docs/setup/getting-started/">https://istio.io/latest/docs/setup/getting-started/</a>) |
| Note: When installing Istio, you need to enable first-party-jwt support (add the &ndash;set values.global.jwtPolicy=first-party-jwt parameter when using the istioctl tool to install), otherwise it will cause client authentication to fail. |
| Attached installation command reference:</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-java" data-lang="java"><span style="display:flex;"><span>curl <span style="color:#719e07">-</span>L https:<span style="color:#586e75">//istio.io/downloadIstio | sh -</span> |
| </span></span><span style="display:flex;"><span>cd istio<span style="color:#719e07">-</span>1.xx.x |
| </span></span><span style="display:flex;"><span>export PATH<span style="color:#719e07">=</span>$PWD<span style="color:#719e07">/</span>bin:$PATH |
| </span></span><span style="display:flex;"><span>istioctl install <span style="color:#719e07">--</span>set profile<span style="color:#719e07">=</span>demo <span style="color:#719e07">--</span>set values.global.jwtPolicy<span style="color:#719e07">=</span>first<span style="color:#719e07">-</span>party<span style="color:#719e07">-</span>jwt <span style="color:#719e07">-</span>y |
| </span></span></code></pre></div><h2 id="start-to-build-dubbo-and-dubbo-samples-environment">Start to build dubbo and dubbo-samples environment</h2> |
| <p>Enter dubbo-dependencies-bom, change grpc version to 1.41.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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">&lt;</span>grpc.version<span style="color:#719e07">&gt;</span>1.41.0<span style="color:#719e07">&lt;/</span>grpc.version<span style="color:#719e07">&gt;</span> |
| </span></span></code></pre></div><p>Enter the dubbo-samples-xds directory and add configuration:</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-java" data-lang="java"><span style="display:flex;"><span>dubbo.application.metadataServiceProtocol<span style="color:#719e07">=</span>dubbo |
| </span></span></code></pre></div><p>Package the dubbo code, switch to the dubbo root directory, and execute the following command to package:</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-java" data-lang="java"><span style="display:flex;"><span>mvn clean <span style="color:#719e07">package</span> -DskipTests |
| </span></span></code></pre></div><p>Switch to the dubbo-samples code, and introduce the newly packaged dubbo code into the pom file of dubbo-samples-xds. |
| Next, modify the debug mode, taking dubbo-xds-consumer as an example: |
| Change the docker file of dubbo-samples-consumer and change the debug mode to suspend=y, the changed docker file is as follows:</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-java" data-lang="java"><span style="display:flex;"><span>FROM openjdk:8<span style="color:#719e07">-</span>jdk |
| </span></span><span style="display:flex;"><span>ADD .<span style="color:#719e07">/</span>target<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">-</span>1.0<span style="color:#719e07">-</span>SNAPSHOT.jar dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">-</span>1.0<span style="color:#719e07">-</span>SNAPSHOT.jar |
| </span></span><span style="display:flex;"><span>EXPOSE 31000 |
| </span></span><span style="display:flex;"><span>CMD java <span style="color:#719e07">-</span>jar <span style="color:#719e07">-</span>agentlib:jdwp<span style="color:#719e07">=</span>transport<span style="color:#719e07">=</span>dt_socket,server<span style="color:#719e07">=</span>y,suspend<span style="color:#719e07">=</span>y,address<span style="color:#719e07">=</span>31000 <span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">-</span>1.0<span style="color:#719e07">-</span>SNAPSHOT.jar |
| </span></span></code></pre></div><p>Then execute the following command to package:</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-java" data-lang="java"><span style="display:flex;"><span>cd dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds |
| </span></span><span style="display:flex;"><span>mvn clean <span style="color:#719e07">package</span> -DskipTests |
| </span></span></code></pre></div><h2 id="build-docker-image">Build docker image</h2> |
| <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-java" data-lang="java"><span style="display:flex;"><span>cd .<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider<span style="color:#719e07">/</span> |
| </span></span><span style="display:flex;"><span># dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider<span style="color:#719e07">/</span>Dockerfile |
| </span></span><span style="display:flex;"><span>docker build <span style="color:#719e07">-</span>t apache<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>demo:dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider_0.0.1 . |
| </span></span><span style="display:flex;"><span>cd ..<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">/</span> |
| </span></span><span style="display:flex;"><span># dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">/</span>Dockerfile |
| </span></span><span style="display:flex;"><span>docker build <span style="color:#719e07">-</span>t apache<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>demo:dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer_0.0.1 . |
| </span></span><span style="display:flex;"><span>cd ..<span style="color:#719e07">/</span> |
| </span></span></code></pre></div><h2 id="create-k8s-namespace">Create K8s namespace</h2> |
| <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-java" data-lang="java"><span style="display:flex;"><span># Initialize the namespace |
| </span></span><span style="display:flex;"><span>kubectl apply <span style="color:#719e07">-</span>f https:<span style="color:#586e75">//raw.githubusercontent.com/apache/dubbo-samples/master/dubbo-samples-xds/deploy/Namespace.yml</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span># <span style="color:#719e07">switch</span> namespace |
| </span></span><span style="display:flex;"><span>kubens dubbo<span style="color:#719e07">-</span>demo |
| </span></span></code></pre></div><p>If the kubens switch is unsuccessful, just install kubectl</p> |
| <h2 id="deploy-container">deploy container</h2> |
| <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-java" data-lang="java"><span style="display:flex;"><span>cd .<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider<span style="color:#719e07">/</span>src<span style="color:#719e07">/</span>main<span style="color:#719e07">/</span>resources<span style="color:#719e07">/</span>k8s |
| </span></span><span style="display:flex;"><span># dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider<span style="color:#719e07">/</span>src<span style="color:#719e07">/</span>main<span style="color:#719e07">/</span>resources<span style="color:#719e07">/</span>k8s<span style="color:#719e07">/</span>Deployment.yml |
| </span></span><span style="display:flex;"><span># dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider<span style="color:#719e07">/</span>src<span style="color:#719e07">/</span>main<span style="color:#719e07">/</span>resources<span style="color:#719e07">/</span>k8s<span style="color:#719e07">/</span>Service.yml |
| </span></span><span style="display:flex;"><span>kubectl apply <span style="color:#719e07">-</span>f Deployment.yml |
| </span></span><span style="display:flex;"><span>kubectl apply <span style="color:#719e07">-</span>f Service.yml |
| </span></span><span style="display:flex;"><span>cd ..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">/</span>src<span style="color:#719e07">/</span>main<span style="color:#719e07">/</span>resources<span style="color:#719e07">/</span>k8s |
| </span></span><span style="display:flex;"><span># dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">/</span>dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">/</span>src<span style="color:#719e07">/</span>main<span style="color:#719e07">/</span>resources<span style="color:#719e07">/</span>k8s<span style="color:#719e07">/</span>Deployment.yml |
| </span></span><span style="display:flex;"><span>kubectl apply <span style="color:#719e07">-</span>f Deployment.yml |
| </span></span><span style="display:flex;"><span>cd ..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span>..<span style="color:#719e07">/</span> |
| </span></span></code></pre></div><p>After successfully executing the above command, the docker desktop containers page looks like this, in which there are several containers in dubbo-samples, including consumer and provider:</p> |
| <p><img src="https://dubbo.apache.org/imgs/user/docker-desktop.png" alt="docker-desktop.png"></p> |
| <p>View the k8s_server_dubbo-samples-xds-provider-XXX log, the following log appears:</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-java" data-lang="java"><span style="display:flex;"><span>Dec 28, 2022 8:42:48 AM org.apache.dubbo.config.deploy.DefaultApplicationDeployer info |
| </span></span><span style="display:flex;"><span>INFO: <span style="color:#719e07">[</span>DUBBO<span style="color:#719e07">]</span> Dubbo Application<span style="color:#719e07">[</span>1.1<span style="color:#719e07">]</span>(dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>provider) is ready., dubbo version: 1.0<span style="color:#719e07">-</span>SNAPSHOT, current host: 10.1.5.64 |
| </span></span><span style="display:flex;"><span>Dec 28, 2022 8:42:49 AM org.apache.dubbo.registry.xds.util.protocol.AbstractProtocol info |
| </span></span><span style="display:flex;"><span>INFO: <span style="color:#719e07">[</span>DUBBO<span style="color:#719e07">]</span> receive notification from xds server, type: type.googleapis.com<span style="color:#719e07">/</span>envoy.config.listener.v3.Listener, dubbo version: 1.0<span style="color:#719e07">-</span>SNAPSHOT, current host: 10.1.5.64 |
| </span></span><span style="display:flex;"><span>Dec 28, 2022 8:42:53 AM org.apache.dubbo.registry.xds.util.protocol.AbstractProtocol info |
| </span></span><span style="display:flex;"><span>INFO: <span style="color:#719e07">[</span>DUBBO<span style="color:#719e07">]</span> receive notification from xds server, type: type.googleapis.com<span style="color:#719e07">/</span>envoy.config.listener.v3.Listener, dubbo version: 1.0<span style="color:#719e07">-</span>SNAPSHOT, current host: 10.1.5.64 |
| </span></span><span style="display:flex;"><span>dubbo service started |
| </span></span></code></pre></div><p><img src="https://dubbo.apache.org/imgs/user/xds-provider-log.png" alt="xds-provider-log.png"></p> |
| <p>Check the k8s_server_dubbo-samples-xds-consumer-XXX log and find that it is waiting for a debug connection: |
| <img src="https://dubbo.apache.org/imgs/user/xds-consumer-listener.png" alt="xds-consumer-listener.png"> |
| Open the command terminal and enter the command to view the pods that are available and in the Running state:</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-java" data-lang="java"><span style="display:flex;"><span>kubectl get pods |
| </span></span></code></pre></div><p><img src="https://dubbo.apache.org/imgs/user/k8s-pods.png" alt="k8s-pods.png"></p> |
| <p>Enter the following command to map the port of the pods to the local:</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-java" data-lang="java"><span style="display:flex;"><span>kubectl port<span style="color:#719e07">-</span>forward dubbo<span style="color:#719e07">-</span>samples<span style="color:#719e07">-</span>xds<span style="color:#719e07">-</span>consumer<span style="color:#719e07">-</span>64c6c6f444<span style="color:#719e07">-</span>kk2vr 31000:31000 |
| </span></span></code></pre></div><p><img src="https://dubbo.apache.org/imgs/user/port-forward.png" alt="port-forward.png"></p> |
| <p>Switch to idea, edit configuration, select attach to remote JVM for debugger mode, select the port of the above docker file expose for port, select dubbo-samples-xds-consumer for module classpath, and click debug to connect successfully |
| <img src="https://dubbo.apache.org/imgs/user/remote-debug.png" alt="remote-debug.png"></p> |
| <p>You can see that the breakpoint has successfully entered: |
| <img src="https://dubbo.apache.org/imgs/user/xds-debug-success.png" alt="xds-debug-success.png"> |
| At this point, check the log of k8s_server_dubbo-samples-xds-consumer-XXX to see that it has been successfully running: |
| <img src="https://dubbo.apache.org/imgs/user/xds-consumer-debug-success-log.png" alt="xds-consumer-debug-success-log.png"></p></description></item></channel></rss> |
