HEX
Server: Apache
System: Linux sg241.singhost.net 2.6.32-896.16.1.lve1.4.51.el6.x86_64 #1 SMP Wed Jan 17 13:19:23 EST 2018 x86_64
User: honghock (909)
PHP: 8.0.30
Disabled: passthru,system,shell_exec,show_source,exec,popen,proc_open
Upload Files
File: //usr/lib/python2.7/site-packages/salt/states/esxdatacenter.py
# -*- coding: utf-8 -*-
'''
Salt states to create and manage VMware vSphere datacenters (datacenters).

:codeauthor: :email:`Alexandru Bleotu <alexandru.bleotu@morganstaley.com>`

Dependencies
============

- pyVmomi Python Module

States
======

datacenter_configured
---------------------

Makes sure a datacenter exists and is correctly configured.

If the state is run by an ``esxdatacenter`` minion, the name of the datacenter
is retrieved from the proxy details, otherwise the datacenter has the same name
as the state.

Supported proxies: esxdatacenter


Example:

1. Make sure that a datacenter named ``target_dc`` exists on the vCenter, using a
``esxdatacenter`` proxy:

Proxy minion configuration (connects passthrough to the vCenter):

.. code-block:: yaml
    proxy:
      proxytype: esxdatacenter
      datacenter: target_dc
      vcenter: vcenter.fake.com
      mechanism: sspi
      domain: fake.com
      principal: host

State configuration:

.. code-block:: yaml

    datacenter_state:
      esxdatacenter.datacenter_configured
'''

# Import Python Libs
from __future__ import absolute_import, print_function, unicode_literals
import logging

# Import Salt Libs
from salt.ext import six
import salt.exceptions

# Get Logging Started
log = logging.getLogger(__name__)
LOGIN_DETAILS = {}


def __virtual__():
    return 'esxdatacenter'


def mod_init(low):
    return True


def datacenter_configured(name):
    '''
    Makes sure a datacenter exists.

    If the state is run by an ``esxdatacenter`` minion, the name of the
    datacenter is retrieved from the proxy details, otherwise the datacenter
    has the same name as the state.

    Supported proxies: esxdatacenter

    name:
        Datacenter name. Ignored if the proxytype is ``esxdatacenter``.
    '''
    proxy_type = __salt__['vsphere.get_proxy_type']()
    if proxy_type == 'esxdatacenter':
        dc_name = __salt__['esxdatacenter.get_details']()['datacenter']
    else:
        dc_name = name
    log.info('Running datacenter_configured for datacenter \'{0}\''
             ''.format(dc_name))
    ret = {'name': name,
           'changes': {},
           'result': None,
           'comment': 'Default'}
    comments = []
    si = None
    try:
        si = __salt__['vsphere.get_service_instance_via_proxy']()
        dcs = __salt__['vsphere.list_datacenters_via_proxy'](
            datacenter_names=[dc_name], service_instance=si)
        if not dcs:
            if __opts__['test']:
                comments.append('State will create '
                                'datacenter \'{0}\'.'.format(dc_name))
            else:
                log.debug('Creating datacenter \'{0}\'. '.format(dc_name))
                __salt__['vsphere.create_datacenter'](dc_name, si)
                comments.append('Created datacenter \'{0}\'.'.format(dc_name))
            log.info(comments[-1])
            ret['changes'].update({'new': {'name': dc_name}})
        else:
            comments.append('Datacenter \'{0}\' already exists. Nothing to be '
                            'done.'.format(dc_name))
            log.info(comments[-1])
        __salt__['vsphere.disconnect'](si)
        ret['comment'] = '\n'.join(comments)
        ret['result'] = None if __opts__['test'] and ret['changes'] else True
        return ret
    except salt.exceptions.CommandExecutionError as exc:
        log.error('Error: {}'.format(exc))
        if si:
            __salt__['vsphere.disconnect'](si)
        ret.update({
            'result': False if not __opts__['test'] else None,
            'comment': six.text_type(exc)})
        return ret