Current File : //proc/thread-self/root/usr/lib/python2.7/site-packages/salt/states/zone.pyo
�
���^c @@ si d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
m Z m Z d d l
m Z d d l m Z d d l m Z e j e � Z i d d 6Z d
Z d � Z d � Z d
� Z d � Z d � Z e d � Z e d � Z! e d � Z" d e d d � Z$ d d d � Z% e d � Z& e d � Z' d � Z( e d d � Z) d � Z* d S( u�
Management of Solaris Zones
:maintainer: Jorge Schrauwen <sjorge@blackdot.be>
:maturity: new
:depends: salt.modules.zoneadm, salt.modules.zonecfg
:platform: solaris
.. versionadded:: 2017.7.0
Below are some examples of how to use this state.
Lets start with creating a zone and installing it.
.. code-block:: yaml
omipkg1_configuration:
zone.present:
- name: omipkg1
- brand: ipkg
- zonepath: /zones/omipkg1
- properties:
- autoboot: true
- ip-type: exclusive
- cpu-shares: 50
- resources:
- attr:
- name: owner
- value: Jorge Schrauwen
- type: string
- attr:
- name: description
- value: OmniOS ipkg zone for testing
- type: string
- capped-memory:
- physical: 64M
omipkg1_installation:
zone.installed:
- name: omipkg1
- require:
- zone: omipkg1_configuration
omipkg1_running:
zone.booted:
- name: omipkg1
- require:
- zone: omipkg1_installation
A zone without network access is not very useful. We could update
the zone.present state in the example above to add a network interface
or we could use a separate state for this.
.. code-block:: yaml
omipkg1_network:
zone.resource_present:
- name: omipkg1
- resource_type: net
- resource_selector_property: mac-addr
- resource_selector_value: "02:08:20:a2:a3:10"
- physical: znic1
- require:
- zone: omipkg1_configuration
Since this is a single tenant system having the owner attribute is pointless.
Let's remove that attribute.
.. note::
The following state run the omipkg1_configuration state will add it again!
If the entire configuration is managed it would be better to add resource_prune
and optionally the resource_selector_property properties to the resource.
.. code-block:: yaml
omipkg1_strip_owner:
zone.resource_present:
- name: omipkg1
- resource_type: attr
- resource_selector_property: name
- resource_selector_value: owner
- require:
- zone: omipkg1_configuration
Let's bump the zone's CPU shares a bit.
.. note::
The following state run the omipkg1_configuration state will set it to 50 again.
Update the entire zone configuration is managed you should update it there instead.
.. code-block:: yaml
omipkg1_more_cpu:
zone.property_present:
- name: omipkg1
- property: cpu-shares
- value: 100
Or we can remove the limit altogether!
.. note::
The following state run the omipkg1_configuration state will set it to 50 again.
Update the entire zone configuration is managed you should set the
property to None (nothing after the :) instead.
.. code-block:: yaml
omipkg1_no_cpu:
zone.property_absent:
- name: omipkg1
- property: cpu-shares
i ( t absolute_importt print_functiont unicode_literalsN( t _parse_valuet# _zonecfg_resource_default_selectors( t CommandExecutionError( t OrderedDict( t mergeu importu import_u zonec C@ s3 d t k r d t k r t St d j t � f Sd S( u(
Provides zone state on Solaris
u zonecfg.createu zoneadm.installu8 {0} state module can only be loaded on Solaris platformsN( t __salt__t Truet Falset formatt __virtualname__( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt __virtual__� s
c C@ s� i | d 6i d 6d d 6d d 6} t | � } t d d t d t � } | | k r�t d | d
t �} | | k s� | | t | � k rlt d r� t | d <nA t d | | | � } | d
| d <d | k r� | d | d <n | d r-t | � | d | <| d d k rid j | | � | d <qiq�| d d k r�| d d k rid j | | � | d <qiq�q�t | d <d j | | � | d <n t | d <d j | � | d <| S( u�
Ensure property has a certain value
name : string
name of the zone
property : string
name of property
value : string
value of property
u nameu changesu resultu u commentu zoneadm.listt installedt
configuredu zonecfg.infot show_allu testu zonecfg.set_propertyu statusu messagesu messageu' The property {0} is was updated to {1}.u+ The property {0} is was not updated to {1}!u' The property {0} is already set to {1}.uB The zone {0} is not in the configured, installed, or booted state.N( t NoneR R R t __opts__R R
( t namet propertyt valuet rett zonest zonecfgt zonecfg_res( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt property_present� s6
"
c C@ s� i | d 6i d 6d d 6d d 6} t d d t d t � } | | k r�t d | d
t �} | | k r�t d r� t | d <nT t d | | � } t d | d
t �} | d
| d <d | k r� | d | d <n | d rM| | k r� d | d | <n) | | | | k r$| | | d | <n | d d k r�d j | � | d <q�q�| d d k r�| d d k r�d j | � | d <q�q�q�t | d <d j | � | d <n t | d <d j | � | d <| S( u(
Ensure property is absent
name : string
name of the zone
property : string
name of property
.. note::
This does a zoneacfg clear call. So the property may be reset to a default value!
Does has the side effect of always having to be called.
u nameu changesu resultu u commentu zoneadm.listR R u zonecfg.infoR u testu zonecfg.clear_propertyu statusu messagesu messageu The property {0} was cleared!u% The property {0} did not get cleared!u The property {0} does not exist!uB The zone {0} is not in the configured, installed, or booted state.N( R R R R R R
( R R R R R R t zonecfg_new( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt property_absent� s<
c
K@ sD i | d 6i d 6d d 6d d 6} t j j j | � } t | � } x. | j � D] \ } } t | | � | | <qP Wt d d t d t � } | | k r#t d | d
t �} i }
|
j | � | |
d <| |
d <| |
d
<| r� | |
| <n | | k r�x�| | D]�} | s'| | | k r
t | d <| rPd j
| | � | d <n d j
| � | d <x� | D]� } t j d | | | k r�| | n d t | | � � | d k r�| | k r�d j
t
| | � � | | <n | | k r�d | d <qj| | t | | � k rjd | d <qjqjW| d d k r�t d rIt | d <n; t d |
� }
|
d | d <d |
k r�|
d | d <n | d rei | d | <| r�i | d | | <n xc | d r�| n g D]K } | r�t | | � | d | | | <q�t | | � | d | | <q�W| d d k r�| rLd j
| | � | d <qbd j
| � | d <q�q�| d d k r�| r�d j
| | � | d <q�d j
| � | d <q�q�q
q
Wn | d d k r@t d r�t | d <nQ d
|
k r�|
d
=n t d |
� }
|
d | d <d |
k r/|
d | d <n | d r�i | d | <| rbi | d | | <n xc | d ru| n g D]K } | r�t | | � | d | | | <qyt | | � | d | | <qyW| d d k r d j
| | � | d <q q | d d k r d j
| | � | d <q q@n t | d <d j
| � | d <| S( u�
Ensure resource exists with provided properties
name : string
name of the zone
resource_type : string
type of resource
resource_selector_property : string
unique resource identifier
resource_selector_value : string
value for resource selection
kwargs : string|int|...
resource properties
.. warning::
Both resource_selector_property and resource_selector_value must be
provided, some properties like ``name`` are already reserved by salt in
states.
.. note::
You can set both resource_selector_property and resource_selector_value
to None for resources that do not require them.
u nameu changesu resultu u commentu zoneadm.listR R u zonecfg.infoR u zoneu
resource_typeu resource_selectoru# the {0} resource {1} is up to date.u the {0} resource is up to date.u7 zone.resource_preent - key=%s value=%s current_value=%su ncpusu {0:.2f}u testu zonecfg.update_resourceu statusu messageu! The {0} resource {1} was updated.u The {0} resource was updated.u% The {0} resource {1} was not updated.u! The {0} resource was not updated.u zonecfg.add_resourceu The {0} resource {1} was added.u# The {0} resource {1} was not added.uB The zone {0} is not in the configured, installed, or booted state.N( R t saltt utilst argst clean_kwargsR t itemsR R t updateR t logt debugt floatR R
( R t
resource_typet resource_selector_propertyt resource_selector_valuet kwargsR t kt vR R t zonecfg_kwargst resourcet keyR ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt resource_present s�
#
#
c
C@ s� i | d 6i d 6d d 6d d 6} | r7 t | � } n d } t d d t d t � } | | k ret d | d
t �} | | k r/x�| | D]�} t d r� t | d <q� | sYt d d
| d | d d d d � } | d | d <| d r&d | d | <| d d k rVd j | � | d <qVq(d | k rC| d | d <q(d j | � | d <q� | | | k r� t d d
| d | d | d | � } | d | d <| d r�i | d | <d | d | | <| d d k r%d j | | � | d <q%q(d | k r| d | d <q(d j | | � | d <q� q� Wn | d d k r�t | d <d j | | � | d <q�n t | d <d j | � | d <| S( un
Ensure resource is absent
name : string
name of the zone
resource_type : string
type of resource
resource_selector_property : string
unique resource identifier
resource_selector_value : string
value for resource selection
.. warning::
Both resource_selector_property and resource_selector_value must be provided, some properties
like ```name``` are already reserved by salt in there states.
.. note::
You can set both resource_selector_property and resource_selector_value to None for
resources that do not require them.
u nameu changesu resultu u commentu zoneadm.listR R u zonecfg.infoR u testu zonecfg.remove_resourcet zoneR& t resource_keyt resource_valueu statusu removedu The {0} resource was removed.u messagesu messageu! The {0} resource was not removed.u! The {0} resource {1} was removed.u% The {0} resource {1} was not removed.u The {0} resource {1} was absent.uB The zone {0} is not in the configured, installed, or booted state.N( R R R R R R R
( R R& R' R( R R R R- R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt resource_absent� sr
c C@ s� i | d 6i d 6d d 6d d 6} t d d t � } | | k r� | | d d k ru t | d <d
j | � | d <q�t d s� t d | | � } n t d s� | d
r� t | d <d | d | <d j | � | d <q�t | d <d j | � | d <n� g | d <| d j d j | � � xB | D]: } | | d | k r"| d j d j | | � � q"q"Wt | d <d j | d � | d <| S( u�
Ensure zone is booted
name : string
name of the zone
single : boolean
boot in single usermode
u nameu changesu resultu u commentu zoneadm.listR u stateu runningu Zone {0} already bootedu testu zoneadm.bootu statusu bootedu Zone {0} bootedu Failed to boot {0}u5 The zone {0} is not in the installed or booted state.u uuiduA The zone {0} has a uuid of {1}, please use the zone name instead!u
N( R R R R R R
t appendt join( R t singleR R t zoneadm_resR0 ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt booted s:
c C@ s� i | d 6i d 6d d 6d d 6} t d d t � } | | k r
| | d d k ru t | d <d
j | � | d <q�t d s� | r� t d | � n
t d
| � } n t d s� | d r� t | d <d | d | <d j | � | d <q�t | d <d j | � | d <n� g | d <| d j d j | � � xB | D]: } | | d | k r5| d j d j | | � � q5q5Wt | d <d j | d � | d <| S( u�
Ensure zone is halted
name : string
name of the zone
graceful : boolean
use shutdown instead of halt if true
u nameu changesu resultu u commentu zoneadm.listR u stateu runningu Zone {0} already haltedu testu zoneadm.shutdownu zoneadm.haltu statusu haltedu Zone {0} haltedu Failed to halt {0}u+ The zone {0} is not in the installed state.u uuiduA The zone {0} has a uuid of {1}, please use the zone name instead!u
N( R R R R R R
R4 R5 ( R t gracefulR R R7 R0 ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt halted; s:
)
c C@ sd i | d 6i d 6d d 6d d 6} t d d t d t � } | | k r�t d r� t | d <d
j | | � | d <d | d | <t d | � r�| r�t | d <i | d <d
j | | � | d <q�q`t j j j � } t d | | � t d | � s�y t d | | � WnR t
k
rbt d | � r?t d | � n t | d <d j | | � | d <q�Xt | d <d j | | � | d <d | d | <q`t d | | � } | s�t | d <d j | | � | d <t d | � r�t d | � q�q`| r�y t d | | � WnR t
k
r`t d | � r=t d | � n t | d <d j | | � | d <q�Xt | d <d j | | � | d <d | d | <q`t | d <d j | | � | d <t d | � r`t d | � q`n� g | d <| d j d j | � � xB | D]: } | | d | k r| d j d j | | � � qqWt | d <d j | d � | d <| S( u�
Export a zones configuration
name : string
name of the zone
path : string
path of file to export too.
replace : boolean
replace the file if it exists
u nameu changesu resultu u commentu zoneadm.listR R u testu) Zone configartion for {0} exported to {1}u exportedu file.file_existsu9 File {0} exists, zone configuration for {1} not exported.u zonecfg.exportu file.moveu file.removeu3 Unable to export zone configuration for {0} to {1}!u/ Zone configuration for {0} was exported to {1}.u
file.get_diffu7 Zone configuration for {0} was already exported to {1}.u9 Unable to be re-export zone configuration for {0} to {1}!u2 Zone configuration for {0} was re-exported to {1}.uE Zone configuration for {0} is different from the one exported to {1}!u The zone {0} does not exist.u uuiduA The zone {0} has a uuid of {1}, please use the zone name instead!u
N(
R R R R R R
R R t filest mkstempR R4 R5 ( R t patht replaceR R t cfg_tmpt cfg_diffR0 ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt exportq s�
c
C@ s� i | d 6i d 6d d 6d d 6} t d d t d t � } | | k r�t d r� t | d <d
j | | � | d <d | d | <q�t d | � r�t d
| | � } | d s� t | d <d j | � | d <q�t | d <d | d | <d
j | | � | d <| j � d k r�t d | t | � } | d | d <| d rdd | d | <d j | | � | d <q�g | d <| d j d j | | � � d | k r�| d j | d � n d j | d � | d <n | j � d k r�t d | | | � } | d | d <| d r0d | d | <d j | | � | d <q�g | d <| d j d j | | � � d | k r{| d j | d � n d j | d � | d <q�q�t | d <d j | � | d <n t | d <d j | � | d <| S( u�
Import a zones configuration
name : string
name of the zone
path : string
path of the configuration file to import
mode : string
either import, install, or attach
nodataset : boolean
do not create a ZFS file system
brand_opts : boolean
brand specific options to pass
.. note::
The mode argument can be set to ``import``, ``install``, or ``attach``.
``import``: will only import the configuration
``install``: will import and then try to install the zone
``attach``: will import and then try to attach of the zone
.. code-block:: yaml
omipkg1:
zone.import:
- path: /foo/bar/baz
u nameu changesu resultu u commentu zoneadm.listR R u testu Zone {0} was imported from {1}.u importedu file.file_existsu zonecfg.importu statusu, Unable to import zone configuration for {0}!u attachu zoneadm.attachu attachedu Zone {0} was attached from {1}.u# Failed to attach zone {0} from {1}!u messageu
u installu zoneadm.installu installedu Zone {0} was installed from {1}.u$ Failed to install zone {0} from {1}!u/ The file {0} does not exists, unable to import!u5 Zone {0} already exists, not importing configuration.N( R R R R R R
t lowerR4 R5 (
R R= t modet nodatasett
brand_optsR R t
res_importt
res_attacht res_install( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt import_� sr
c C@ s6 i | d 6i d 6d d 6g d 6} | s1 g } n | s@ g } n | j t i | d 6� � | j t i | d 6� � t d d t d t � } t d
r� d | d <| d j d j | � � n | | k rFt d
r� i t d 6} g | d <n t d
| | | � } | d rFt | d <d | d | <| d j d j | � � qFn t d
st | d <t | t � r�x8| D]-} t | t � s�t | � d k r�t
j d | � qpn x� | j � D]� \ } }
d } |
s�t
| | � } n |
r t | | |
� } n | r�| d r| d n t | d <| d j | d � t | d � d k r�d | d k rpi | d d <n t | d d | d � | d d <q�q�q�WqpWn t | t � rxL| D]A} t | t � s�t | � d k r�t
j d | � q�n x | j � D]�\ } }
t d | d t �}
i } | | d <t |
t � rmx$ |
D] } | j t | � � qMWn t } d } d | k r�| d } | d =n d | k r�| d } | d =n | r�| t k r�t | } n d } | rt | | d d | d | r | | n d �} nG | | d <| | k r>| | | d <n
d | d <| | d <t | � } | r| d rx| d n t | d <| d j | d � t | d � d k r�d | d k r�i | d d <n t | d d | d � | d d <q�qqWq�Wqn t | d t � r2d j | d � | d <n | S( u3
Ensure a zone with certain properties and resources
name : string
name of the zone
brand : string
brand of the zone
zonepath : string
path of the zone
properties : list of key-value pairs
dict of properties
resources : list of key-value pairs
dict of resources
.. note::
If the zone does not exist it will not be installed.
You can use the ```zone.installed``` state for this.
.. note::
Default resource selectors:
- fs: dir
- net: mac-addr
- device: match
- rctl: name
- attr: name
- dataset: name
- admin: user
.. warning::
Properties and resource will not be removed when they
are absent from the state!
For properties, simple set them to ```None```.
For resources, add the ```resource_prune``` property
and set it to ```True```. Also specify the
```resource_selector_property``` if the default is not
the one you want.
u nameu changesu resultu commentu brandu zonepathu zoneadm.listR R u testu9 Cannot determine of changes would happen to the zone {0}.u statusu zonecfg.createu createdu The zone {0} was created.i u+ zone.present - failed to parse property: %si u propertyu+ zone.present - failed to parse resource: %su zonecfg.infoR u
resource_typeu resource_pruneu resource_selector_propertyR' R( u resource_selector_valueu resourceu
N( R R4 R R R R R t
isinstancet listt lenR# t warningR! R R R
t
merge_dictR" t dictR R3 R/ R5 ( R t brandt zonepatht
propertiest resourcesR R t
res_createt propR. R t resR- R t resource_cfgt respvt resource_pruneR' ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt presentJ s� )
" 4
"
7c C@ s� i | d 6i d 6d d 6d d 6} t d d t d t � } | | k r�t d r t | d <d
| d | <d j | � | d <q�t | d <| ra| | d d! k rat d | � } t d | � } | d | d <| d r� d | d | <d j | � | d <q#g | d <| d j d j | � � d | k rG| d j | d � n d j | d � | d <n� | | d d k r#t d | � } | d | d <| d r�d | d | <d j | � | d <q#g | d <| d j d j | � � d | k r | d j | d � n d j | d � | d <n | d r�t d | � } | d | d <| d ryd | d | <d j | � | d <q�g | d <| d j d j | � � d | k r�| d j | d � n d j | d � | d <q�n t | d <d j | � | d <| S(" u�
Ensure a zone is absent
name : string
name of the zone
uninstall : boolean
when true, uninstall instead of detaching the zone first.
u nameu changesu resultu u commentu zoneadm.listR R u testu removedu Zone {0} was removed.u stateu runningu installedu zoneadm.haltu zoneadm.uninstallu statusu uninstalledu The zone {0} was uninstalled.u Failed to uninstall zone {0}!u messageu
u zoneadm.detachu detachedu The zone {0} was detached.u Failed to detach zone {0}!u zonecfg.deleteu deletedu The zone {0} was delete.u Failed to delete zone {0}!u Zone {0} does not exist.N( u runningu installed( R R R R R R4 R5 ( R t uninstallR R t res_haltt
res_uninstallt
res_detacht
res_delete( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt absent� s`
c C@ sg i | d 6i d 6d d 6d d 6} t d d t d t � } | | k rF| | d d
k r&t d ru i t d 6} n t d
| | � } | d | d <| d r� d | d | <d j | � | d <qCg | d <| d j d j | � � d | k r | d j | d � n d j | d � | d <qct | d <d j | � | d <n t | d <d j | � | d <| S( u�
Ensure zone is attached
name : string
name of the zone
force : boolean
force attach the zone
u nameu changesu resultu u commentu zoneadm.listR R u stateu
configuredu testu statusu zoneadm.attachu attachedu The zone {0} was attached.u Failed to attach zone {0}!u messageu
u zone {0} already attached.u zone {0} is not configured!N( R R R R R R4 R5 R
( R t forceR R RG ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt attached" s0
c C@ sd i | d 6i d 6d d 6d d 6} t d d t d t � } | | k rC| | d d
k r#t d ru i t d 6} n t d
| � } | d | d <| d r� d | d | <d j | � | d <q@g | d <| d j d j | � � d | k r | d j | d � n d j | d � | d <q`t | d <d j | � | d <n t | d <d j | � | d <| S( uN
Ensure zone is detached
name : string
name of the zone
u nameu changesu resultu u commentu zoneadm.listR R u stateu
configuredu testu statusu zoneadm.detachu detachedu The zone {0} was detached.u Failed to detach zone {0}!u messageu
u zone {0} already detached.u zone {0} is not configured!N( R R R R R R4 R5 ( R R R R^ ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt detachedL s0
c C@ sj i | d 6i d 6d d 6d d 6} t d d t d t � } | | k rI| | d d
k r)t d ru i t d 6} n t d
| | | � } | d | d <| d r� d | d | <d j | � | d <qFg | d <| d j d j | � � d | k r| d j | d � n d j | d � | d <qft | d <d j | � | d <n t | d <d j | � | d <| S( u�
Ensure zone is installed
name : string
name of the zone
nodataset : boolean
do not create a ZFS file system
brand_opts : boolean
brand specific options to pass
u nameu changesu resultu u commentu zoneadm.listR R u stateu
configuredu testu statusu zoneadm.installu installedu The zone {0} was installed.u Failed to install zone {0}!u messageu
u zone {0} already installed.u zone {0} is not configured!N( R R R R R R4 R5 R
( R RD RE R R RH ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyR u s0
c C@ sd i | d 6i d 6d d 6d d 6} t d d t d t � } | | k rC| | d d
k r#t d ru i t d 6} n t d
| � } | d | d <| d r� d | d | <d j | � | d <q@g | d <| d j d j | � � d | k r | d j | d � n d j | d � | d <q`t | d <d j | � | d <n t | d <d j | � | d <| S( uQ
Ensure zone is uninstalled
name : string
name of the zone
u nameu changesu resultu u commentu zoneadm.listR R u stateu
configuredu testu statusu zoneadm.uninstallu uninstalledu The zone {0} was uninstalled.u Failed to uninstall zone {0}!u messageu
u zone {0} already uninstalled.u zone {0} is not configured!N( R R R R R R4 R5 ( R R R R] ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt uninstalled� s0
(+ t __doc__t
__future__R R R t loggingt salt.utils.argsR t salt.utils.atomicfilet salt.utils.filest salt.modules.zonecfgR R t salt.exceptionsR t salt.utils.odictR t salt.utils.dictupdateR RN t getLoggert __name__R# t __func_alias__R R
R R R/ R3 R
R8 R R: RA R RI RZ R` Rb Rc R Rd ( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/zone.pyt <module>o s8
3 6 � d 6 6 te� C * ),
Mini Shell