Current File : //lib/python2.7/site-packages/salt/modules/swarm.pyc
�
���^c @@ s d Z d d l m Z m Z m Z d d l Z y d d l Z e Z Wn e
k
r] e Z n Xd Z d � Z
d � Z d � Z e e e d � Z e e e d � Z e d
� Z e e e e e e e d � Z e d � Z e d
� Z e d � Z e e d � Z e e e e e d � Z d S( u�
Docker Swarm Module using Docker's Python SDK
=============================================
:codeauthor: Tyler Jones <jonestyler806@gmail.com>
.. versionadded:: 2018.3.0
The Docker Swarm Module is used to manage and create Docker Swarms.
Dependencies
------------
- Docker installed on the host
- Docker python sdk >= 2.5.1
Docker Python SDK
-----------------
.. code-block:: bash
pip install -U docker
More information: https://docker-py.readthedocs.io/en/stable/
i ( t absolute_importt unicode_literalst print_functionNu swarmc C@ s t r
t St d f S( uC
Load this module if the docker python module is installed
uG The swarm module failed to load: Docker python module is not available.( t
HAS_DOCKERt __virtualname__t False( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt __virtual__* s c C@ s+ t r t j � t d <n t d t d <d S( Nu clientu idu server_name( R t dockert from_envt __context__t
__grains__( t self( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt __init__3 s c C@ s& t j d d � } | j � } | d S( u�
Get the Docker Swarm Manager or Worker join tokens
CLI Example:
.. code-block:: bash
salt '*' swarm.swarm_tokens
t base_urlu unix://var/run/docker.socku
JoinTokens( R t APIClientt
inspect_swarm( t clientt service( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt swarm_tokens9 s
c C@ s� yU i } t d j j | | | � d j t d � } | j i | d 6t � d 6� Wn+ t k
r� i } | j i d d 6� n X| S( u�
Initalize Docker on Minion as a Swarm Manager
advertise_addr
The ip of the manager
listen_addr
Listen address used for inter-manager communication,
as well as determining the networking interface used
for the VXLAN Tunnel Endpoint (VTEP).
This can either be an address/port combination in
the form 192.168.1.1:4567,
or an interface followed by a port number,
like eth0:4567
force_new_cluster
Force a new cluster if True is passed
CLI Example:
.. code-block:: bash
salt '*' swarm.swarm_init advertise_addr='192.168.50.10' listen_addr='0.0.0.0' force_new_cluster=False
u clientuS Docker swarm has been initialized on {0} and the worker/manager Join token is belowu server_nameu Commentu Tokensu] Please make sure you are passing advertise_addr, listen_addr and force_new_cluster correctly.u Error( R t swarmt initt formatt updateR t TypeError( t advertise_addrt listen_addrt force_new_clustert salt_returnt output( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt
swarm_initH s
c C@ s� yY i } t d j j d | g d | d | � t d d } | j i | d 6| d 6� Wn+ t k
r� i } | j i d d
6� n X| S( u�
Join a Swarm Worker to the cluster
remote_addr
The manager node you want to connect to for the swarm
listen_addr
Listen address used for inter-manager communication if the node gets promoted to manager,
as well as determining the networking interface used for the VXLAN Tunnel Endpoint (VTEP)
token
Either the manager join token or the worker join token.
You can get the worker or manager token via ``salt '*' swarm.swarm_tokens``
CLI Example:
.. code-block:: bash
salt '*' swarm.joinswarm remote_addr=192.168.50.10 listen_addr='0.0.0.0' token='SWMTKN-1-64tux2g0701r84ofq93zppcih0pe081akq45owe9ts61f30x4t-06trjugdu7x2z47j938s54il'
u clientt remote_addrsR t
join_tokenu server_nameu has joined the Swarmu Commentu Manager_Addruu Please make sure this minion is not part of a swarm and you are passing remote_addr, listen_addr and token correctly.u Error( R R t joinR R ( t remote_addrR t tokenR R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt joinswarms s
c C@ sC i } t d j j d | � t d d } | j i | d 6� | S( u�
Force the minion to leave the swarm
force
Will force the minion/worker/manager to leave the swarm
CLI Example:
.. code-block:: bash
salt '*' swarm.leave_swarm force=False
u clientt forceu server_nameu has left the swarmu Comment( R R t leaveR ( R$ R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt leave_swarm� s
c C@ s y� i } t j j d d | �} t j j d i | | 6� } t d j j d | d | d | d | d | � t d
d | }
| j i |
d 6t d
d
6| d 6| d 6| d 6| d 6| d 6| d 6| d 6� Wn+ t k
r� i } | j i d d 6� n X| S( u~
Create Docker Swarm Service Create
image
The docker image
name
Is the service name
command
The docker command to run in the container at launch
hostname
The hostname of the containers
replicas
How many replicas you want running in the swarm
target_port
The target port on the container
published_port
port thats published on the host/os
CLI Example:
.. code-block:: bash
salt '*' swarm.service_create image=httpd name=Test_Service command=None hostname=salthttpd replicas=6 target_port=80 published_port=80
u
replicatedt replicast portsu clientt namet imaget commandt modet
endpoint_specu server_nameu* has a Docker Swarm Service running named u Infou Minionu Nameu Imageu Commandu Hostnameu Replicasu Target_Portu Published_Portu Please make sure you are passing arguments correctly [image, name, command, hostname, replicas, target_port and published_port]u Error( R t typest ServiceModet EndpointSpecR t servicest createR R ( R* R) R+ t hostnameR' t target_portt published_portR t replica_modeR( t echoback( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt service_create� s. &
c C@ s� y�i } t j d d � } | j d | � } t j j j | � } t j j j | � } | d d } | d d } | d d d } | d d d
} | d }
| d } | d
} | d d }
| d d d d } | d d } | d d d d } x� | D]� } | d } | d } | d } | d } | j i | d 6| d 6|
d 6| d 6| d 6| d 6| d 6| d 6| d! 6| d" 6| d 6| d# 6t d$ d% 6| d 6� qWWn+ t
k
r�i } | j i d& d' 6� n X| S(( u�
Swarm Service Information
service_name
The name of the service that you want information on about the service
CLI Example:
.. code-block:: bash
salt '*' swarm.swarm_service_info service_name=Test_Service
R
u unix://var/run/docker.sockR u Versionu Indexu Specu Nameu EndpointSpecu Modeu Portsu IDu CreatedAtu UpdatedAtu Labelsu
Replicatedu Replicasu Endpointu
VirtualIPsu TaskTemplateu
ContainerSpecu Imageu
PublishedPortu
TargetPortu PublishModeu Protocolu Service Nameu
Service IDu Networku Network Modeu
Creation Dateu Update Dateu Published Portu Target Portu Published Modeu Docker Imageu server_nameu Minion Idu service_name arg is missing?u Error( R R t inspect_servicet saltt utilst jsont dumpst loadsR R R ( t service_nameR R R t getdatat dumpt versionR) t network_modeR( t swarm_idt create_datet update_datet labelsR' t networkR* t itemsR5 R4 t published_modet protocol( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt swarm_service_info� sP
c C@ s| yJ i } t j d d � } | j | � } | j i | d 6t d d 6� Wn+ t k
rw i } | j i d d 6� n X| S( u�
Remove Swarm Service
service
The name of the service
CLI Example:
.. code-block:: bash
salt '*' swarm.remove_service service=Test_Service
R
u unix://var/run/docker.socku Service Deletedu server_nameu Minion IDu service arg is missing?u Error( R R t remove_serviceR R R ( R R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyRM $ s
c C@ sS y!i } t j d d � } | j d i | d 6� } t j j j | � } t j j j | � } x� | D]� } | d d d } | d d } | d d } | d
}
| d d } | d d
} | d }
| d d } | j i | d 6| d 6| d 6|
d
6| d 6| d
6|
d 6| d 6� qe WWn+ t k
rNi } | j i d d 6� n X| S( u�
Displays Information about Swarm Nodes with passing in the server
server
The minion/server name
CLI Example:
.. code-block:: bash
salt '*' swarm.node_ls server=minion1
R
u unix://var/run/docker.sockt filtersu nameu Descriptionu Engineu
EngineVersionu Platformu Hostnameu IDu Specu Roleu Availabilityu Statusu Versionu Indexu Docker Versionu Rolesu> The server arg is missing or you not targeting a Manager node?u Error(
R R t nodesR: R; R< R= R> R R ( t serverR R R R@ RA RI t docker_versiont platformt hostnamest idst rolet availabilityt statusRB ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt node_ls= s6
c C@ s� t j d d � } yB | d k r: | j | d t �} | S| j | d t �} | SWn, t k
r� i } | j i d d 6� | SXd S( uU
Remove a node from a swarm and the target needs to be a swarm manager
node_id
The node id from the return of swarm.node_ls
force
Forcefully remove the node/minion from the service
CLI Example:
.. code-block:: bash
salt '*' swarm.remove_node node_id=z4gjbe9rwmqahc2a91snvolm5 force=false
R
u unix://var/run/docker.socku TrueR$ u/ Is the node_id and/or force=True/False missing?u ErrorN( R R t remove_nodet TrueR R R ( t node_idR$ R R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyRY g s
c C@ s� t j d d � } yU i } i | d 6| d 6| d 6} | j d | d | d | � | j i | d 6� Wn+ t k
r� i } | j i d
d 6� n X| S( u�
Updates docker swarm nodes/needs to target a manager node/minion
availability
Drain or Active
node_name
minion/node
role
role of manager or worker
node_id
The Id and that can be obtained via swarm.node_ls
version
Is obtained by swarm.node_ls
CLI Example:
.. code-block:: bash
salt '*' docker_util.update_node availability=drain node_name=minion2 role=worker node_id=3k9x7t8m4pel9c0nqr3iajnzp version=19
R
u unix://var/run/docker.socku Availabilityu Nameu RoleR[ RB t node_specu Node InformationuO Make sure all args are passed [availability, node_name, role, node_id, version]u Error( R R t update_nodeR R ( RV t node_nameRU R[ RB R R R\ ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyR] � s
( t __doc__t
__future__R R R t salt.utils.jsonR: R RZ R t ImportErrorR R R R R t strt intt boolR R# R& R8 RL RM RX RY R] ( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/swarm.pyt <module> sD
) $ : 7 *
Mini Shell