Changes between Version 8 and Version 9 of MasterSlaveCommunication


Ignore:
Timestamp:
Jan 4, 2017, 1:39:57 AM (21 months ago)
Author:
rutsky
Comment:

update "slave" with "worker" (only in text, protocol is not updated)

Legend:

Unmodified
Added
Removed
Modified
  • MasterSlaveCommunication

    v8 v9  
    1212'''Initial Interaction''':
    1313
    14 Authentication: Currently the slave authenticates with the Twisted Cred (newcred) mechanism, using the username and password supplied to buildslave create-slave.
     14Authentication: Currently the worker authenticates with the Twisted Cred (newcred) mechanism, using the username and password supplied to buildslave create-slave.
    1515> This occurs as part of the setup of the [http://twistedmatrix.com/documents/current/core/howto/pb-intro.html PB] connection, and so doesn't fit into the RPC
    1616> style of the rest of the current protocol. As it happens, the login mechanism is also used to allow the same port to be used for other PB communications.
    1717
    18 After that the master requests information about the slave, via the remote methods {{{ getSlaveInfo}}}, {{{ getVersion}}}, and {{{ getCommands}}}.
     18After that the master requests information about the worker, via the remote methods {{{ getSlaveInfo}}}, {{{ getVersion}}}, and {{{ getCommands}}}.
    1919
    20 The {{{SlaveInfo}}} currently consists of the contents of the slave's info/ directory.[[BR]]
     20The {{{SlaveInfo}}} currently consists of the contents of the worker's info/ directory.[[BR]]
    2121This also contains the keys[[BR]]
    22 {{{environ}}}: copy of the slaves environment[[BR]]
    23 {{{system}}}: OS the slave is running (extracted from pythons os.name)[[BR]]
    24 {{{basedir}}}:base directory where slave is running[[BR]]
     22{{{environ}}}: copy of the workers environment[[BR]]
     23{{{system}}}: OS the worker is running (extracted from pythons os.name)[[BR]]
     24{{{basedir}}}:base directory where worker is running[[BR]]
    2525
    2626
    27 {{{getVersion}}} returns the version of slave.
    28 {{{getCommands}}} returns the list of (name, version) for all commands the slave recognizes.
     27{{{getVersion}}} returns the version of worker.
     28{{{getCommands}}} returns the list of (name, version) for all commands the worker recognizes.
    2929These methods do not take any arguments.
    3030
     
    4444The command can be interrupted via an external trigger, which calls {{{interruptCommand}}}. This method takes {{{stepID}}} and a reason {{{why}}} as arguments.
    4545
    46 The running command provides [http://docs.buildbot.net/latest/developer/master-slave.html#updates Updates], sent as arguments to {{{update}}} from the {{{SlaveBuilder}}} to the master, during execution.
     46The running command provides [http://docs.buildbot.net/latest/developer/master-worker.html#updates Updates], sent as arguments to {{{update}}} from the {{{SlaveBuilder}}} to the master, during execution.
    4747
    4848At the end of a command, the completion of the command is indicated by calling {{{complete}}}, with failures as optional arguments.
    4949
    50 The master and slave(in versions greater than 0.8.3) can initiate the shutdown of a slave. The master can call {{{shutdown}}} to shut down the slave, while the slave can also request for a graceful shutdown.
     50The master and worker (in versions greater than 0.8.3) can initiate the shutdown of a worker. The master can call {{{shutdown}}} to shut down the worker, while the worker can also request for a graceful shutdown.
    5151> Which it does by calling {{{shutdown}}} on the master.
    5252
     
    5858 [[Image(ProposedSequenceDiagram.png)]]
    5959
    60 Initial changes will include reducing the number of roundtrips, a busy-signal from the slave, protocol versioning, graceful handling of disconnections, etc. Future changes would include support for several masters, etc.
     60Initial changes will include reducing the number of roundtrips, a busy-signal from the worker, protocol versioning, graceful handling of disconnections, etc. Future changes would include support for several masters, etc.