# salt.states.modjk_worker

## Manage modjk workers

Send commands to a modjk load balancer via the peer system.

This module can be used with the prereq requisite to remove/add the worker from the load balancer before deploying/restarting service.

Mandatory Settings:

- The minion needs to have permission to publish the modjk.* functions (see here for information on configuring peer publishing permissions)

- The modjk load balancer must be configured as stated in the modjk execution module `documentation`

salt.states.modjk_worker.activate(name, lbn, target, profile='default', tgt_type='glob')

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  Activate the named worker from the lbn load balancers at the targeted minions

  Example:

      disable-before-deploy:
        modjk_worker.activate:
          - name: {{ grains['id'] }}
          - lbn: application
          - target: 'roles:balancer'
          - tgt_type: grain

salt.states.modjk_worker.disable(name, lbn, target, profile='default', tgt_type='glob')

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  Disable the named worker from the lbn load balancers at the targeted minions. The worker will get traffic only for current sessions and won't get new ones.

  Example:

      disable-before-deploy:
        modjk_worker.disable:
          - name: {{ grains['id'] }}
          - lbn: application
          - target: 'roles:balancer'
          - tgt_type: grain

salt.states.modjk_worker.stop(name, lbn, target, profile='default', tgt_type='glob')

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  Stop the named worker from the lbn load balancers at the targeted minions The worker won't get any traffic from the lbn

  Example:

      disable-before-deploy:
        modjk_worker.stop:
          - name: {{ grains['id'] }}
          - lbn: application
          - target: 'roles:balancer'
          - tgt_type: grain