Permalink
d24e001 Jun 12, 2016
204 lines (166 sloc) 5.36 KB

Build Status Gitter

Dubbo is a distributed, high performance RPC framework which empowers applications with service import/export capabilities.

It contains three key parts, which include:

  • Remoting: a network communication framework providing sync-over-async and request-response messaging.
  • Clustering: a remote procedure call abstraction with load-balancing/failover/clustering capabilities.
  • Registration: a service directory framework for service registration and service event publish/subscription

For more details, please refer to wiki or dubbo.io.

Quick Start

Export service:

<bean id="barService" class="com.foo.BarServiceImpl" />
<dubbo:service interface="com.foo.BarService" ref="barService" />

Refer to service:

<dubbo:reference id="barService" interface="com.foo.BarService" />

<bean id="barAction" class="com.foo.BarAction">
    <property name="barService" ref="barService" />
</bean>

Source Building

  1. Install the git and maven command line:

    yum install git
    or: apt-get install git
    cd ~
    wget http://www.apache.org/dist//maven/binaries/apache-maven-2.2.1-bin.tar.gz
    tar zxvf apache-maven-2.2.1-bin.tar.gz
    vi .bash_profile
    append: export PATH=$PATH:~/apache-maven-2.2.1/bin
    source .bash_profile
  2. Checkout the dubbo source code:

    cd ~
    git clone https://github.com/alibaba/dubbo.git dubbo
    git checkout master
    or: git checkout -b dubbo-2.4.0
  3. Import the dubbo source code to eclipse project:

    cd ~/dubbo
    mvn eclipse:eclipse

    Then configure the project in eclipse by following the steps below:

    • Eclipse -> Menu -> File -> Import -> Exsiting Projects to Workspace -> Browse -> Finish
    • Context Menu -> Run As -> Java Application:
      • dubbo-demo-provider/src/test/java/com.alibaba.dubbo.demo.provider.DemoProvider
      • dubbo-demo-consumer/src/test/java/com.alibaba.dubbo.demo.consumer.DemoConsumer
      • dubbo-monitor-simple/src/test/java/com.alibaba.dubbo.monitor.simple.SimpleMonitor
      • dubbo-registry-simple/src/test/java/com.alibaba.dubbo.registry.simple.SimpleRegistry
    • Edit Config:
      • dubbo-demo-provider/src/test/resources/dubbo.properties
      • dubbo-demo-consumer/src/test/resources/dubbo.properties
      • dubbo-monitor-simple/src/test/resources/dubbo.properties
      • dubbo-registry-simple/src/test/resources/dubbo.properties
  4. Build the dubbo binary package:

    cd ~/dubbo
    mvn clean install -Dmaven.test.skip
    cd dubbo/target
    ls
  5. Install the demo provider:

    cd ~/dubbo/dubbo-demo-provider/target
    tar zxvf dubbo-demo-provider-2.4.0-assembly.tar.gz
    cd dubbo-demo-provider-2.4.0/bin
    ./start.sh
  6. Install the demo consumer:

    cd ~/dubbo/dubbo-demo-consumer/target
    tar zxvf dubbo-demo-consumer-2.4.0-assembly.tar.gz
    cd dubbo-demo-consumer-2.4.0/bin
    ./start.sh
    cd ../logs
    tail -f stdout.log
  7. Install the simple monitor:

    cd ~/dubbo/dubbo-simple-monitor/target
    tar zxvf dubbo-simple-monitor-2.4.0-assembly.tar.gz
    cd dubbo-simple-monitor-2.4.0/bin
    ./start.sh
    http://127.0.0.1:8080
  8. Install the simple registry:

    cd ~/dubbo/dubbo-simple-registry/target
    tar zxvf dubbo-simple-registry-2.4.0-assembly.tar.gz
    cd dubbo-simple-registry-2.4.0/bin
    ./start.sh
    cd ~/dubbo/dubbo-demo-provider/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=dubbo://127.0.0.1:9090
    cd ../bin
    ./restart.sh
    cd ~/dubbo/dubbo-demo-consumer/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=dubbo://127.0.0.1:9090
    cd ../bin
    ./restart.sh
    cd ~/dubbo/dubbo-simple-monitor/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=dubbo://127.0.0.1:9090
    cd ../bin
    ./restart.sh
  9. Install the zookeeper registry:

    cd ~
    wget http://www.apache.org/dist//zookeeper/zookeeper-3.3.3/zookeeper-3.3.3.tar.gz
    tar zxvf zookeeper-3.3.3.tar.gz
    cd zookeeper-3.3.3/conf
    cp zoo_sample.cfg zoo.cfg
    vi zoo.cfg
    - edit: dataDir=/home/xxx/data
    cd ../bin
    ./zkServer.sh start
    cd ~/dubbo/dubbo-demo-provider/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=zookeeper://127.0.0.1:2181
    cd ../bin
    ./restart.sh
    cd ~/dubbo/dubbo-demo-consumer/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=zookeeper://127.0.0.1:2181
    cd ../bin
    ./restart.sh
    cd ~/dubbo/dubbo-simple-monitor/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=zookeeper://127.0.0.1:2181
    cd ../bin
    ./restart.sh
  10. Install the redis registry:

    cd ~
    wget http://redis.googlecode.com/files/redis-2.4.8.tar.gz
    tar xzf redis-2.4.8.tar.gz
    cd redis-2.4.8
    make
    nohup ./src/redis-server redis.conf &
    cd ~/dubbo/dubbo-demo-provider/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=redis://127.0.0.1:6379
    cd ../bin
    ./restart.sh
    cd ~/dubbo/dubbo-demo-consumer/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=redis://127.0.0.1:6379
    cd ../bin
    ./restart.sh
    cd ~/dubbo/dubbo-simple-monitor/conf
    vi dubbo.properties
    - edit: dubbo.registry.adddress=redis://127.0.0.1:6379
    cd ../bin
    ./restart.sh
  11. Install the admin console:

    cd ~/dubbo/dubbo-admin
    mvn jetty:run -Ddubbo.registry.address=zookeeper://127.0.0.1:2181
    http://root:root@127.0.0.1:8080