分布式计算框架Gearman原理详解

港控/mmm° 2022-05-17 06:54 165阅读 0赞

## 什么是Gearman？ ##

Gearman提供了一个通用的应用程序框架，用于将工作转移到更适合于工作的其他机器或流程。它允许你并行工作，负载平衡处理，并在语言间调用函数。它可用于从高可用性网站到传输数据库复制事件的各种应用程序。换句话说，它是分布式处理交流的神经系统。关于Gearman的一些优点：

*  **开源**它是免费的！（在这个词的两个意思中）Gearman有一个活跃的开源社区，如果你需要帮助或者想贡献，很容易参与进来。担心授权？Gearman是BSD。
 *  **多语言** \- 有一些语言的接口，这个列表正在增长。您也可以选择使用一种语言提交工作的客户端编写异构应用程序，并在另一种语言中执行该工作的工作人员。
 *  **灵活** \- 您不受限于任何特定的设计模式。您可以使用您选择的任何模型快速组合分布式应用程序，这些选项之一是Map / Reduce。
 *  **快速** \- Gearman有一个简单的协议和接口，用C / C ++编写的优化的，线程化的服务器可以最大限度地减少应用程序开销。
 *  **嵌入式** \- 由于Gearman速度快，重量轻，适用于各种尺寸的应用。以最小的开销引入现有的应用程序也很容易。
 *  **没有单点故障** \- Gearman不仅可以帮助扩展系统，而且还可以通过容错方式实现。
 *  **消息大小没有限制** \- Gearman支持最多4gig的单个消息。需要做更大的事情？没问题Gearman可以大块消息。
 *  **担心缩放？** \- 不要担心Gearman。克雷格的名单，Tumblr，Yelp，Etsy，...发现别人已经知道了多年。

内容正在定期更新，所以请经常查看。 如果您想了解更多信息或参与其中，您可能还想查看其他[沟通][Link 1]形式！

# Gearman如何工作？ #

![Gearman堆栈][Gearman]

一个Gearman驱动的应用程序由三部分组成：一个客户端，一个工作者和一个作业服务器。客户端负责创建要运行的作业并将其发送到作业服务器。作业服务器将找到可以运行作业并转发作业的合适工作人员。工作人员执行客户端请求的工作，并通过作业服务器向客户端发送响应。Gearman提供您的应用程序调用的客户端和工作者API来与Gearman作业服务器（也称为gearmand）交谈，因此您不需要处理网络或作业的映射。在内部，gearman客户端和工作者API使用TCP套接字与作业服务器进行通信。为了更详细地解释Gearman的工作原理，我们来看看一个简单的应用程序，它将颠倒字符串中字符的顺序。这个例子在PHP中给出，

我们首先编写一个客户端应用程序，负责发送作业并等待结果，以便打印出来。它通过使用Gearman客户端API来发送一些与函数名相关的数据，在这种情况下是函数`reverse`。这个代码是（为了简洁，省略了错误处理）：

<?php
    // Reverse Client Code
    $client = new GearmanClient();
    $client->addServer();
    print $client->do("reverse", "Hello World!");

此代码初始化一个客户端类，将其配置为使用带有`add_server`（不带参数表示使用`127.0.0.1`默认端口）的作业服务器 ，然后通知客户端API以`reverse`工作负载“Hello world！” 运行该功能。就Gearman而言，函数名称和参数是完全任意的，所以您可以发送适合您应用程序的任何数据结构（文本或二进制文件）。此时，Gearman客户端API将把该作业打包到一个Gearman协议数据包中，并将其发送到作业服务器以查找可以运行该`reverse` 功能的合适的工作人员。现在让我们看看工人代码：

<?php
    // Reverse Worker Code
    $worker = new GearmanWorker();
    $worker->addServer();
    $worker->addFunction("reverse", function ($job) {
      return strrev($job->workload());
    });
    while ($worker->work());

![Gearman流][Gearman 1]

这段代码定义了一个函数`my_reverse_function`，它接受一个字符串并返回该字符串的反转。它被一个工作对象用来注册一个函数，该函数`reverse`被设置为连接到与客户端相同的本地作业服务器。当作业服务器接收到要运行的作业时，它查看已经注册了该功能名称`reverse`的工作人员列表，并将该作业转发给其中一个空闲工作人员。然后，Gearman工作者API接受这个请求，运行该功能`my_reverse_function`，并通过作业服务器将该功能的结果发送回客户端。

如您所见，客户端和工作者API（以及作业服务器）处理作业管理和网络通信，因此您可以专注于应用程序部分。有几种不同的方法可以在Gearman中运行作业，包括异步处理和优先作业的背景。有关详细信息，请参阅可用于各种API 的 [文档][Link 2]。

# Gearman如何有用？ #

上面的例子看起来像是很多工作来运行一个函数，但是有很多方法可以用。最简单的答案是，你可以使用Gearman作为用不同语言编写的客户端和工作者之间的接口。如果您希望PHP Web应用程序调用用C语言编写的函数，则可以将PHP客户端API与C工作程序API配合使用，并在中间粘贴作业服务器。当然，还有更高效的方式来做这件事（比如用C写一个PHP扩展），但是你可能需要一个PHP客户端和一个Python工作者，或者一个MySQL客户端和一个Perl工作者。您可以轻松地混合和匹配任何支持的语言界面，只需要所有应用程序都能够理解所发送的工作量。你最喜欢的语言是不是支持？获得[参与项目][Link 1]，对于你或者现有的Gearman开发人员来说，在C库的顶部放置一个语言包装可能相当容易。

Gearman的另一个有用的方法是把工作代码放在一个更适合工作的单独的机器上（或者一组机器上）。假设您的PHP Web应用程序想要进行图像转换，但这是在Web服务器机器上运行它的太多处理。您可以将映像发送到单独的一组工作机器上进行转换，这样负载不会影响Web服务器和其他PHP脚本的性能。通过这样做，您也可以获得一种自然形式的负载平衡，因为作业服务器仅向闲置的工作人员发送新作业。如果在特定机器上运行的所有工作人员都很忙，则不必担心在那里发送新工作。这使得多核服务器的扩展非常简单：工人机器上有16个核心吗？启动你的工人的16个实例（或更多，如果他们没有CPU绑定）。也可以无缝添加新机器来扩展您的工作池，只需启动它们，安装工作代码，并将它们连接到现有的作业服务器。

![Gearman集群][Gearman 2]

现在你可能会问如果作业服务器死亡？您可以运行多个作业服务器，并让客户端和工作人员连接到配置的第一个可用作业服务器。这样，如果一个工作服务器死亡，客户端和工作人员会自动故障转移到另一个工作服 你可能不想运行太多的作业服务器，但有两到三个是冗余的好主意。左图显示了一个简单的Gearman集群的外观。

从这里，您可以根据需要扩展您的客户和工作人员。作业服务器可以轻松处理一次连接数百个客户端和工作人员。您可以在容量允许的情况下绘制自己的物理（或虚拟）机器生产线，可能将负载分配到任意数量的机器。有关具体使用和安装的更多细节，请参阅[示例][Link 3]部分。

更新来。

## 2Gearman架构中的三个角色 ##

client：请求的发起者，工作任务的需求方（可以是C、PHP、Java、Perl、Mysql udf等等）

Job Server：请求的调度者，负责将client的请求转发给相应的worker（gearmand服务进程创建）

worker：请求的处理者（可以是C、PHP、Java、Perl等等）

### Gearman是如何工作的？ ###

![498077-20170609175022497-2018362409.png][]

从上图可以看出，Gearman Client API，Gearman Worker API，Gearman Job Server都是由gearman本身提供，我们在应用中只需要调用即可。目前client与worker api都很丰富。

## 3Gearman的吞吐能力 ##

经过的测试，结果如下：

系统环境：ubuntu-14.0.4 1个CPU 4核 2G内存 （虚拟机）

默认启动：./gearmand -d

client.php

1.  <?php
2.  echo "starting...", microtime(true), "n";
3.  $gmc = new GearmanClient();
4.  $gmc->setCompleteCallBack(function($task)\{
5.  //echo $task->data(), "n";
6.  \});
7.  $gmc->addServer("127.0.0.1", 4730);
8.  for ($i = 0; $i < 100000; $i++) \{
9.  $gmc->addTaskBackground("reserve", "just test it", null, $i);
10. \}
11. $gmc->runTasks();
12. echo "end...", microtime(true), "n";

worker.php

1.  <?php
2.  $gmw = new GearmanWorker();
3.  $gmw->addServer("127.0.0.1", 4730);
4.  $gmw->addFunction("reserve", function($job) \{
5.  if ($job->unique() == 99999) \{
6.  echo microtime(true), "n";
7.  \}
8.  return strrev($job->workload());
9.  \});
10. while($gmw->work());

启动一个job server实例：job server IP:127.0.0.1 PORT:4730

启动一个worker: php worker.php

worker注册reserve函数，将client的job字符串反转后返回。

client工作任务的消息为：just test it（12字节）

同步：4100/s

异步：25700/s

memcached内存准持久化的吞吐能力测试

./gearmand -d -q libmemcached —libmemcached-servers=127.0.0.1:11211

client投递100000个工作任务：16400/s

### Gearman典型的部署结构 ###

![498077-20170609175037872-1245879385.png][]

### Gearman支持的特性 ###

高可用

启动两个job server，他们是独立的服务进程，有各自的内存队列。当一个job server进程出现故障，另一个job server可以正常调度。（worker api与client api可以完成job server故障的切换）。在任何时候我们可以关闭某个worker，即使那个worker正在处理工作任务（Gearman不会让正在被执行的job丢失的，由于worker在工作时与Job server是长连接，所以一旦worker发生异常，Job server能够迅速感知并重新派发这个异常worker刚才正在执行的工作）

负载均衡（附gearman协议会详细解释）

job server并不主动分派工作任务，而是由worker从空闲状态唤醒之后到job server主动抓取工作任务。

可扩展

松耦合的接口和无状态的job，只需要启动一个worker，注册到Job server集群即可。新加入的worker不会对现有系统有任何的影响。

分布式

gearman是分布式的任务分发框架，worker与job server，client与job server通信基于tcp的socket连接。

队列机制

gearman内置内存队列，默认情况队列最大容量为300W，可以配置最大支持2^32-1，即4 294 967 295。

高性能

作为Gearman的核心，Job server的是用C/C++实现的，由于只是做简单的任务派发，因此系统的瓶颈不会出在Job server上。

### 两种工作任务 ###

后台工作任务Background job——时序图

![498077-20170609175113872-596896993.png][]

由图可知，client提交完job，job server成功接收后返回JOB\_CREATED响应之后，client就断开与job server之间的链接了。后续无论发生什么事情，client都是不关心的。同样，job的执行结果client端也没办法通过Gearman消息框架 获得。

一般工作任务Non-background job——时序图

![498077-20170609175205809-1511343143.png][]

由图可知，client端在job执行的整个过程中，与job server端的链接都是保持着的，这也给job完成后job server返回执行结果给client提供了通路。同时，在job执行过程当中，client端还可以发起job status的查询。当然，这需要worker端的支持的。

## 4关于持久化 ##

对于队列持久化的问题，是一个值得考虑的问题。持久化必然影响高性能。gearman支持后台工作任务的持久化，支持drizzle、mysql、memcached的持久化。对于client提交的background job，Job server除了将其放在内存队列中进行派发之外，还会将其持久化到外部的持久化队列中。一旦Job server发生问题重启，外部持久化队列中的background job将会被恢复到内存中，参与Job server新的派发当中。这保证了已提交未执行的background job不会由于Job server发生异常而丢失。并且我测试发现如果开启了持久化，那么后台工作任务会先将工作任务写到持久化介质，然后在入内存队列，再执行。非后台工作任务，由于client与job server是保持长连接的状态，如果工作任务执行异常，client可以灵活处理，所以无须持久化。

### Gearman框架中的一个问题 ###

从典型部署结构看出，两个Job server之间是没有连接的。也就是Job server间是不共享background job的。如果通过让两个Job server指向同一个持久化队列，可以让两个Job serer互相备份。但实际上，这样是行不通的。因为Job server只有在启动时才会将持久化队列中的background job转入到内存队列。也就是说，Job server1如果宕机且永远不启动，Job server2一直正常运行，那么Job server1宕机前被提交到Job server1的未被执行的background job将永远都呆在持久化队列中，得不到执行。另外如果多个job server实例指向同一个持久化队列，同时重启多个job server实例会导致持久队列中的工作任务被多次载入，从而导致消息重复处理。

### 我建议的部署结构 ###

![498077-20170609175225637-1420898389.png][]

采用memcached做后台工作任务的准持久化队列，最好memcached和job server在内网的不同机器。两个机器的两个服务同时挂掉的可能性比较小，同时也保证了高性能。而且memcached应该为两个相互独立实例，防止其上述的gearman框架中的问题。我们可以做一个监控脚本，如果某个job server异常退出，可以重启，也最大化的保证了job server的高可用。

## 5关于Gearman的管理工具 ##

目前有一个现在的管理工具，https://github.com/brianlmoon/GearmanManager，但是只支持php-5.2，不过可以自行修改支持php-5.4，我建议如果使用PHP作为worker进程，使用php-5.4以上的版本。该工具的设计方法可以借鉴，可以比较好的管理gearman worker。

### 应用场景 ###

1.  结合linux crontab，php脚本负责产生job，将任务分发到多台服务器周期性的并发执行。可以取代目前我们比较多的crontab的工作任务。
2.  邮件短信发送
3.  异步log
4.  跨语言相互调用（对于密集型计算的需求，可以用C实现，PHP直接调用）
5.  其他耗时脚本

### Gearman安装（unbuntu） ###

下载

<table> 
 <tbody> 
  <tr> 
   <td> <pre>$&gt;wget https://launchpadlibrarian.net/165674261/gearmand-1.1.12.tar.gz </pre> </td> 
  </tr> 
 </tbody> 
</table>

安装依赖包

$>sudo apt-get install libboost1.55-all-dev gperf libevent libevent-dev uuid libmemcached-dev  
    $>tar zxvf gearmand-1.1.12.tar.gz 
    $>cd gearmand-1.1.12 
    $>/configure --prefix=/home/phpboy/Server/gearman 
    $>make & make install

启动

a)默认启动

<table> 
 <tbody> 
  <tr> 
   <td> <pre>$&gt;./gearman -d </pre> </td> 
  </tr> 
 </tbody> 
</table>

b)支持memcached准持久化

$>./gearmand -d -q libmemcached --libmemcached-servers=127.0.0.1:11211

安装php的Gearman扩展

$>wget http://pecl.php.net/get/gearman-1.1.2.tgz 
    $>tar zxvf gearman-1.1.2.tgz#cd gearman-1.1.2 
    $>phpize 
    $>./configure --with-php-config=php-config 
    $>make & make install

php client api与php worker api

可以用上面我的测试的示例

附Gearmand（job server的启动参数简单说明）

-b, –backlog=BACKLOG 连接请求队列的最大值 
    -d, –daemon Daemon 守护进程化  
    -f, –file-descriptors=FDS 可打开的文件描述符数量  
    -h, –help  
    -l, –log-file=FILE Log 日志文件 
    -L, –listen=ADDRESS 开启监听的地址  
    -p, –port=PORT 开启监听的端口  
    -P, –pid-file=FILE File pid file  
    -r,–protocol=PROTOCOL 使用的协议  
    -q, –queue-type=QUEUE 持久化队列类型  
    -t, –threads=THREADS I/O线程数量  
    -u, –user=USER 进程的有效用户名  
    libdrizzle Options:  
    --libdrizzle-host=HOST Host of server.   
    --libdrizzle-port=PORT Port of server.   
    --libdrizzle-uds=UDS Unix domain socket for server.   
    --libdrizzle-user=USER User name for authentication.   
    --libdrizzle-password=PASSWORD Password for authentication.   
    --libdrizzle-db=DB Database to use.   
    --libdrizzle-table=TABLE Table to use.   
    --libdrizzle-mysql Use MySQL protocol.  
    libmemcached Options:   
    --libmemcached-servers=SERVER_LIST List of Memcached servers to use.  
    libsqlite3 Options:   
    --libsqlite3-db=DB Database file to use.   
    --libsqlite3-table=TABLE Table to use.  
    libpq Options:   
    --libpq-conninfo=STRING PostgreSQL connection information string.   
    --libpq-table=TABLE Table to use.  
    http Options:   
    --http-port=PORT Port to listen on.

### Gearman通信协议 ###

总括

Gearman工作在TCP上，默认端口为4730，client与job server、worker与job server的通信都基于此tcp的socket连接。client是工作任务的发起者，worker是可以注册处理函数的工作任务执行者，job server为工作的调度者。协议包含请求报文与响应报文两个部分，所有发向job server的数据包（TCP报文段的数据部分）认为是请求报文，所有从job server发出的数据包（TCP报文段的数据部分）认为是响应报文。worker或者client与job server间的通信是基于二进制数据流的，但在管理client也有基于行文本协议的通信。

请求的报文体

![498077-20170609180236903-344364176.png][]

响应的报文体

![498077-20170609180252012-1911726999.png][]

后台工作任务Background job

![498077-20170609180316512-1589450192.png][]

一般工作任务Non-background job

![498077-20170609180330934-152776774.png][]

二进制包

请求报文与响应报文是由二进制包封装。一个二进制包由头header和可选的数据部分data组成。

header的组成

1.  报文类别，请求报文或者响应报文，4个字节  
    “�REQ” 请求报文  
    “�RES” 响应报文
2.  包类型，高（大）字节序（网络字节序），4个字节可能的类型有

类型值  名称    报文类型 发送者

1 CAN_DO REQ    Worker    
    2 CANT_DO REQ    Worker    
    3 RESET_ABILITIES     REQ    Worker    
    4 PRE_SLEEP           REQ    Worker    
    5 (unused)            -      -   
    6 NOOP                RES    Worker    
    7 SUBMIT_JOB          REQ    Client    
    8 JOB_CREATED         RES    Client    
    9 GRAB_JOB            REQ    Worker    
    10 NO_JOB              RES    Worker    
    11 JOB_ASSIGN          RES    Worker    
    12 WORK_STATUS         REQ    Worker    
    13 WORK_COMPLETE REQ    Worker   
    14 WORK_FAIL           REQ    Worker  
    15 GET_STATUS          REQ    Client  
    16 ECHO_REQ            REQ    Client/Worker  
    17 ECHO_RES            RES    Client/Worker  
    18 SUBMIT_JOB_BG       REQ    Client 
    19 ERROR               RES    Client/Worker  
    20 STATUS_RES          RES    Client  
    21 SUBMIT_JOB_HIGH     REQ    Client  
    22 SET_CLIENT_ID       REQ    Worker  
    23 CAN_DO_TIMEOUT REQ    Worker  
    24 ALL_YOURS           REQ    Worker  
    25 WORK_EXCEPTION      REQ    Worker  
    26 OPTION_REQ          REQ    Client/Worker  
    27 OPTION_RES          RES    Client/Worker  
    28 WORK_DATA           REQ    Worker    
    29 WORK_WARNING        REQ    Worker   
    30 GRAB_JOB_UNIQ       REQ    Worker  
    31 JOB_ASSIGN_UNIQ     RES    Worker  
    32 SUBMIT_JOB_HIGH_BG  REQ    Client  
    33 SUBMIT_JOB_LOW      REQ    Client  
    34 SUBMIT_JOB_LOW_BG   REQ    Client  
    35 SUBMIT_JOB_SCHED    REQ    Client  
    36 SUBMIT_JOB_EPOCH    REQ    Client

1.  可选数据部分长度，高（大）字节序（网络字节序），4个字节，可表示的值为4294967295

数据部分，数据部分的各个部分为null字符分隔。

具体各包类型的说明

client和worker可发送请求报文

ECHO\_REQ

当job server收到此包类型的请求报文时，就简单的产生一个包类型为ECHO\_RES，同时将请求报文的数据部分作为响应报文的数据部分的报文。主要用于测试或者调试

如：

Client -> Job Server  00 52 45 51 0REQ  报文类型  00 00 00 a0 16 (Packet type: ECHO_ERQ)    00 00 00 04 4 (Packet length)  74 65 73 74 test   (Workload)

ECHO\_RESclient和worker可接收响应报文

当job server响应ECHO\_REQ报文时发送的包类型为ECHO\_RES的响应报文

如：

Job Server -> Client  00 52 45 53 0RES  报文类型  00 00 00 a1 17 (Packet type: ECHO_ERS)  00 00 00 04 4 (Packet length)  74 65 73 74 test   (Workload)

当job server发生错误时，需要通知client或者workerERROR

client发送的请求报文：（仅能由client发送的请求报文）  
SUBMIT\_JOB, SUBMIT\_JOB\_BG,SUBMIT\_JOB\_HIGH, SUBMIT\_JOB\_HIGH\_BG,SUBMIT\_JOB\_LOW, SUBMIT\_JOB\_LOW\_BG

当client有一个工作任务需要运行，就会提交相应的请求报文，job server响应包类型为JOB\_CREATED数据部分为job handle的响应报文。SUBMIT\_JOB为普通的工作任务，client得到状态更新及通知任务已经完成的响应；SUBMIT\_JOB\_BG为异步的工作任务，client不关心任务的完成情况；SUBMIT\_JOB\_HIGH为高优先级的工作任务，SUBMIT\_JOB\_HIGH\_BG为高优先级的异步任务；SUBMIT\_JOB\_LOW为低优先级的工作任务，SUBMIT\_JOB\_LOW\_BG为低优先级的异步任务。

如：

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 8 9 10 11 12 13 </pre> </td> 
   <td> <pre>Client -&gt; Job Server  00 52 45 51 0REQ        (报文类型)  00 00 00 07 7 (Packet type: SUBMIT_JOB)  00 00 00 0d 13 (Packet length)  72 65 76 65 72 73 65 00 reverse0 (Function)  00                         � (Unique ID)  74 65 73 74 test (Workload) </pre> </td> 
  </tr> 
 </tbody> 
</table>

SUBMIT\_JOB\_SCHED

和SUBMIT\_JOB\_BG类似，此类型的工作任务不会立即执行，而在设置的某个时间运行。

如：

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 </pre> </td> 
   <td> <pre>Client -&gt; Job Server  00 52 45 51 0REQ        (报文类型)  00 00 00 23 35 (Packet type: SUBMIT_JOB_SCHED)  00 00 00 0d 13 (Packet length)  72 65 76 65 72 73 65 00 reverse0 (Function)  00                         � (Unique ID)  01                         � (minute 0-59)  01                         � (hour 0-23)  01                         � (day of month 1-31)  01                         � (day of month 1-12)  01                         � (day of week  0-6)  74 65 73 74 test (Workload) </pre> </td> 
  </tr> 
 </tbody> 
</table>

SUBMIT\_JOB\_EPOCH

和SUBMIT\_JOB\_SCHED作用一样，只是将设置的时间定为了uinx时间戳GET\_STATUS获取某个工作任务执行的状态信息

OPTION\_REQ

设置client与job server连接的选项

client获取的响应报文：

JOB\_CREATED响应包类型为SUBMIT\_JOB\*的请求报文，数据部分为job handle

WORK\_DATA, WORK\_WARNING, WORK\_STATUS, WORK\_COMPLETE,WORK\_FAIL, WORK\_EXCEPTION

对于后台运行的工作任务，任务执行信息可以通过包类型为上面的值来查看。

STATUS\_RES

响应包类型为GET\_STATUS的请求报文，通常用来查看一个后台工作任务是否已经完成，以及完成的百分比。

OPTION\_RES

响应包类型为OPTION\_REQ的请求报文

worker发送的请求报文：

CAN\_DO

通知job server可以执行给定的function name的任务，此worker将会放到一个链表，当job server收到一个function name的工作任务时，worker为被唤醒。

CAN\_DO\_TIMEOUT

和CAN\_DO类似，只是针对给定的function\_name的任务设置了一个超时时间。

CANT\_DO

worker通知job server已经不能执行给定的function name的任务

RESET\_ABILITIES

worker通知job server不能执行任何function name的任务

PRE\_SLEEP

worker通知job server它将进入sleep阶段，而之后此worker会被包类型为NOOP的响应报文唤醒。

GRAB\_JOB

worker向job server抓取工作任务，job server将会响应NO\_JOB或者JOB\_ASSIG

NGRAB\_JOB\_UNIQ

和GRAB\_JOB类似，但是job server在有工作任务时将会响应JOB\_ASSIGN\_UNIQ

WORK\_DATA

worker请求报文的数据部分更新client

WORK\_WARNING

worker请求报文代表一个warning，它应该被对待为一个WARNING

WORK\_STATU

Sworker更新某个job handle的工作状态，job server应该储存这些信息，以便响应之后client的GET\_STATUS请求

WORK\_COMPLETE

通知job server及所有连接的client，数据部分为返回给client的数据

WORK\_FAIL

通知job server及所有连接的client，工作任务执行失败

WORK\_EXCEPTION

通知job server及所有连接的client，工作任务执行失败并给出相应的异常

SET\_CLIENT\_ID

设置worker ID，从而job server的控制台及报告命令可以标识各个worker，数据部分为worker实例的标识

ALL\_YOURS

暂未实现

worker获取的响应报文：

NOOP

job server唤醒sleep的worker，以便可以开始抓取工作任务

NO\_JOB

job server响应GRAB\_JOB的请求，通知worker没有等待执行的工作任务

JOB\_ASSIGN

job server响应GRAB\_JOB的请求，通知worker有需要执行的工作任务

JOB\_ASSIGN\_UNIQ

job server响应GRAB\_JOB\_UNIQ的请求，和JOB\_ASSIGN一样，只是为client传递了一个唯一标识

基于上述的协议描述一个完整的例子

worker注册可以执行的工作任务

Worker -> Job Server

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 </pre> </td> 
   <td> <pre>00 52 45 51 0REQ (Magic)  00 00 00 01 1 (Packet type: CAN_DO)  00 00 00 07 7 (Packet length)  72 65 76 65 72 73 65 reverse (Function) </pre> </td> 
  </tr> 
 </tbody> 
</table>

worker检测或者抓取工作任务

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 </pre> </td> 
   <td> <pre>Worker -&gt; Job Server  00 52 45 51 0REQ (Magic)  00 00 00 09 9 (Packet type: GRAB_JOB)  00 00 00 00 0 (Packet length) </pre> </td> 
  </tr> 
 </tbody> 
</table>

job server响应worker的抓取工作（没有工作任务）

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 </pre> </td> 
   <td> <pre>00 52 45 53 0RES (Magic)  00 00 00 0a 10 (Packet type: NO_JOB)  00 00 00 00 0 (Packet length) </pre> </td> 
  </tr> 
 </tbody> 
</table>

worker通知job server开始sleep

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 </pre> </td> 
   <td> <pre>00 52 45 51 0REQ (Magic)  00 00 00 04 4 (Packet type: PRE_SLEEP)  00 00 00 00 0 (Packet length) </pre> </td> 
  </tr> 
 </tbody> 
</table>

client提交工作任务

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 8 9 10 11 12 13 </pre> </td> 
   <td> <pre>Client -&gt; Job Server  00 52 45 51 0REQ        (Magic)  00 00 00 07 7 (Packet type: SUBMIT_JOB)  00 00 00 0d 13 (Packet length)  72 65 76 65 72 73 65 00 reverse0 (Function)  00                         � (Unique ID)  74 65 73 74 test (Workload) </pre> </td> 
  </tr> 
 </tbody> 
</table>

job server响应client的SUBMIT\_JOB请求，返回job handle

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 </pre> </td> 
   <td> <pre>00 52 45 53 0RES (Magic)  00 00 00 08 8 (Packet type: JOB_CREATED)  00 00 00 07 7 (Packet length)  48 3a 6c 61 70 3a 31 H:lap:1 (Job handle) </pre> </td> 
  </tr> 
 </tbody> 
</table>

job server唤醒worker

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1 2 3 4 5 6 7 </pre> </td> 
   <td> <pre>Job Server -&gt; Worker  00 52 45 53 0RES (Magic)  00 00 00 06 6 (Packet type: NOOP)  00 00 00 00 0 (Packet length) </pre> </td> 
  </tr> 
 </tbody> 
</table>

worker的抓取工作任务

1.  Worker -> Job Server
2.  
3.  00 52 45 51 \\0REQ (Magic)
4.  
5.  00 00 00 09 9 (Packet type: GRAB\_JOB)
6.  
7.  00 00 00 00 0 (Packet length)

job server分配工作任务给worker

1.  Job Server -> Worker
2.  
3.  00 52 45 53 \\0RES (Magic)
4.  
5.  00 00 00 0b 11 (Packet type: JOB\_ASSIGN)
6.  
7.  00 00 00 14 20 (Packet length)
8.  
9.  48 3a 6c 61 70 3a 31 00 H:lap:1\\0 (Job handle)
10. 
11. 72 65 76 65 72 73 65 00 reverse\\0 (Function)
12. 
13. 74 65 73 74 test (Workload)

worker完成工作任务通知job server

1.  00 52 45 51 \\0REQ (Magic)
2.  
3.  00 00 00 0d 13 (Packet type: WORK\_COMPLETE)
4.  
5.  00 00 00 0c 12 (Packet length)
6.  
7.  48 3a 6c 61 70 3a 31 00 H:lap:1\\0 (Job handle)
8.  
9.  74 73 65 74 tset (Response)

job server通知client完成了工作任务

Job Server -> Client

1.  00 52 45 53 \\0RES (Magic)
2.  
3.  00 00 00 0d 13 (Packet type: WORK\_COMPLETE)
4.  
5.  00 00 00 0c 12 (Packet length)
6.  
7.  48 3a 6c 61 70 3a 31 00 H:lap:1\\0 (Job handle)
8.  
9.  74 73 65 74 tset (Response)

每个client与job server是全双工通信，在一个socket可以完成多个工作任务的投递，但是收到任务的执行结果的顺序可能与投递的顺序不一致。

详见：[http://gearman.org/protocol/][http_gearman.org_protocol]

## 6总结worker的工作流程 ##

1.  Worker通过CAN\_DO消息，注册到Job server上。
2.  随后发起GRAB\_JOB，主动要求分派任务。
3.  Job server如果没有job可分配，就返回NO\_JOB。
4.  Worker收到NO\_JOB后，进入空闲状态，并给Job server返回PRE\_SLEEP消息，告诉Job server:”如果有工作来的话，用NOOP请求我先。”
5.  Job server收到worker的PRE\_SLEEP消息后，明白了发送这条消息的worker已经进入了空闲态。
6.  这时如果有job提交上来，Job server会给worker先发一个NOOP消息。
7.  Worker收到NOOP消息后，发送GRAB\_JOB向Job server请求任务。
8.  Job server把工作派发给worker。
9.  Worker干活，完事后返回WORK\_COMPLETE给Job server。

[Link 1]: http://gearman.org/communication/
[Gearman]: /images/20220517/0ad33ee052bb47b4989fd17ec53ec2b0.png
[Gearman 1]: /images/20220517/5c689d4c43104a548f4da229879273a0.png
[Link 2]: http://gearman.org/documentation/
[Gearman 2]: /images/20220517/714168358c984e649a20d16be9e1293f.png
[Link 3]: http://gearman.org/examples/
[498077-20170609175022497-2018362409.png]: /images/20220517/b1c68da03da94a0589a714784b717dd4.png
[498077-20170609175037872-1245879385.png]: /images/20220517/0dc4178e5fd64c31a6a7cbc238bc8644.png
[498077-20170609175113872-596896993.png]: /images/20220517/2f87a356b24a40dbb0e46f8b882c3263.png
[498077-20170609175205809-1511343143.png]: /images/20220517/f5ec76fda9174a8cad0683c5d5cc36f0.png
[498077-20170609175225637-1420898389.png]: /images/20220517/8534181de7524f708d26225e38ba2263.png
[498077-20170609180236903-344364176.png]: /images/20220517/565665ad4c604026aa5232c53f964cf5.png
[498077-20170609180252012-1911726999.png]: /images/20220517/4cc70ce59daf4272ac9e0513fe850c0a.png
[498077-20170609180316512-1589450192.png]: /images/20220517/2b08c127d2f34af19c81b61d35e0afe9.png
[498077-20170609180330934-152776774.png]: /images/20220517/e9c0406ed7e341d88538c187a93d750d.png
[http_gearman.org_protocol]: http://gearman.org/protocol/