25.Salt2019.2.0-Release-Notes-Codename-Fluorine-Salt2019.2.0版本功能特性说明.md · wyaopeng/SaltStack-Chinese-ManualBook

Salt2019.2.0 Release Notes Codename Fluorine - Salt2019.2.0 的新版本功能特性说明
>官网原文参见：https://docs.saltstack.com/en/latest/topics/releases/2019.2.0.html

# PYTHON 2.7 DEPRECATION
Python 2.7在2020年1月1日将达到其生命周期终止时间（EOL），SaltStack将在Sodium发行版本或之后的版本中弃用对Python 2的支持。该决定有待进一步的社区讨论确定。
>Codename是SaltStack为了便于记忆和使用，而为Salt发行版本命名的一种代码名称。SaltStack采用了元素周期表中各元素的名称和顺序，每个元素均代指某一个的Salt发行版本，依次使用。
>
>例如:
- Salt 2016.10.0 —— Carbon(碳)
- Salt 2017.7.0 —— Nitrogen(氮)
- Salt 2018.3.0 —— Oxygen(氧)
- Salt 2019.2.0 —— Fluorine(氟)
- ? —— Neon(氖)
- ? —— Sodium(钠)

# YAML RENDERER的在非后向兼容方面的变化
在早期版本中，假设数据是包含unicode类型的键/值的列表或字典，这被认为是Python 2中的有效用法：
```jinja
/etc/foo.conf:
  file.managed:
    - source: salt://foo.conf.jinja
    - template: jinja
    - context:
        data: {{ data }}
```
一个常见的用例是使用一个Salt的自定义[Jinja过滤器](https://docs.saltstack.com/en/latest/topics/jinja/index.html#std:jinja_ref-custom-jinja-filters)返回列表或词典，例如[ipv4过滤器](https://docs.saltstack.com/en/latest/topics/jinja/index.html#std:jinja_ref-ipv4)。

在Python 2中，Jinja将使用“u”前缀（例如{u'foo'：u'bar'}）以在列表/字典中显示unicode字符串类型。 虽然属于无效的YAML，但早期版本会成功加载这些值。

截至本版本，上述SLS将会导致错误消息。 如果仍然需要允许将数据结构直接转储到SLS文件中，请使用[tojson Jinja](http://jinja.pocoo.org/docs/2.10/templates/#tojson)过滤器：
```jinja
/etc/foo.conf:
  file.managed:
    - source: salt://foo.conf.jinja
    - template: jinja
    - context:
        data: {{ data|tojson }}
```
>Note：
>此过滤器是添加到了Jinja 2.9中。 但是，也不必担心！ 在Salt 2018.3.3版本也添加了一个类似功能的tojson过滤器，如果此过滤器尚不存在，将使用该过滤器，以实现功能兼容，使其在RHEL 7和Ubuntu 14.04等平台上可用，这些平台上提供是旧版本的Jinja。

>Important：
>json_encode_dict和json_encode_list过滤器实际上并没有将结果转储到JSON。 而且由于tojson完成了那些过滤器的设计目的，它们现在已被弃用，并将在Neon版本中被移除。 在所有使用json_encode_dict和json_encode_list的场景下都应该替换为使用tojson过滤器。

# ANSIBLE PLAYBOOK STATE AND EXECUTION MODULES
除了包含Oxygen版本中的ansible模块外，2019.2.0版本中还增加了运行playbooks的功能。 这包括一个ansible playbooks状态模块，它可以在目标主机上用来运行ansible playbooks，或者用在编排state runner中。
```yaml_utf8
install nginx:
  ansible.playbooks:
    - name: install.yml
    - git_repo: git://github.com/gtmanfred/playbook.git
    - git_kwargs:
        rev: master
```
playbooks模块还支持指定一个git repo地址，用来获取部分运行所需的资源文件，或者在运行playbook时可以指定使用一个特定的目录。

# NETWORK AUTOMATION - 网络自动化
从此版本开始，Salt为各种网络操作系统提供了更广泛的支持，以及配置变更或命令执行的功能。

## NETBOX
在上一版本2018.3.0中新添加的[netbox执行模块](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.netbox.html#module-salt.modules.netbox)的功能，在该版本中扩展出了更多的可用功能列表：
- netbox.create_circuit
- netbox.create_circuit_provider
- netbox.create_circuit_termination
- netbox.create_circuit_type
- netbox.create_device
- netbox.create_device_role
- netbox.create_device_type
- netbox.create_interface
- netbox.create_interface_connection
- netbox.create_inventory_item
- netbox.create_ipaddress
- netbox.create_manufacturer
- netbox.create_platform
- netbox.create_site
- netbox.delete_interface
- netbox.delete_inventory_item
- netbox.delete_ipaddress
- netbox.get_circuit_provider
- netbox.get_interfaces
- netbox.get_ipaddresses
- netbox.make_interface_child
- netbox.make_interface_lag
- netbox.openconfig_interfaces
- netbox.openconfig_lacp
- netbox.update_device
- netbox.update_interface

除了这个执行模块，Salt用户还可以通过[netbox External Pillar模块](https://docs.saltstack.com/en/latest/ref/pillar/all/salt.pillar.netbox.html#module-salt.pillar.netbox)直接从NetBox将数据加载到设备Pillar中。
>netbox是网络设施信息化与可视化管理项目，有兴趣的同学可以移动这里：https://github.com/digitalocean/netbox/tree/master

## NETMIKO
NETMIKO=Network + Paramiko

[Netmiko](https://github.com/ktbyers/netmiko)是一个简化Paramiko SSH与网络设备连接的多供应商库，现已正式集成到Salt中。 现在可以通过netmiko代理模块或直接从任何Salt Minions使用它，传递连接凭据 - 请参阅[netmiko执行模块](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.netmiko_mod.html#module-salt.modules.netmiko_mod)的文档。

## ARISTA
Arista交换机现在可以在pyeapi代理模块下进行管理，并通过pyeapi执行模块执行RPC请求。

## CISCO NEXUS
虽然在版本代号Carbon（2016.11）中已经添加了对基于SSH的操作的支持，但新的nxos_api代理模块和nxos_api允许通过NX-API管理Cisco Nexus交换机。

重要的是要注意这些模块没有第三方依赖，因此它们可以直接使用任何Salt Minion。 这也意味着用户可以直接在Nexus交换机上安装常规Salt Minion，并像常规服务器一样的管理这些网络设备。

## GENERAL-PURPOSE MODULES
新的ciscoconfparse执行模块可用于具有Cisco IOS样式配置（一个空格缩进）的各种网络平台的基本配置解析、审计或验证，以及大括号分隔的配置样式。

iosconfig可用于Cisco IOS样式配置的各种配置操作，例如： configuration cleanup, tree representation of the config等。

## NAPALM
### COMMIT AT AND COMMIT CONFIRMED
从此版本开始，NAPALM用户可以执行计划提交（通常称为“commit at”）和“commit confirmed”（除非用户通过运行另一个命令确认，否则将恢复配置更改）。 这些功能可通过net.load_config和net.load_template执行函数或netconfig.managed的commit_in，commit_at，revert_in或revert_at参数获得。

对应的执行函数net.confirm_commit或net.cancel_commit，以及State函数netconfig.commit_cancelled或netconfig.commit_confirmed可用于确认或取消提交。

请注意，无论网络设备本机是否支持，任何平台都可以使用提交确认和提交已取消的功能。 但是，要小心谨慎，并确保在生产中使用它们之前阅读并理解警告。

>NAPALM（具有多供应商支持的网络自动化和可编程性抽象层）是一个Python库，它实现了一组使用统一API与不同网络设备操作系统交互的功能。NAPALM支持多种方法来连接设备，操作配置或检索数据，对Cisco和Juniper等设备的支持较好。

### MULTIPLE TEMPLATES RENDERED SIMULTANEOUSLY
net.load_template执行函数和netconfig.managed State函数的template_name参数现在支持使用模板列表了。 当一个非常大的Jinja模板被拆分成多个更小且更易于阅读的模板时，这一点尤其有用，这些模板最终可以在其他国家或地区得到重复使用。 例如，使用两个不同的模板并通过一次提交更改设备配置，以下语法不能同时管理NTP和BGP的配置：
```YAML
manage_bgp_and_ntp:
  netconfig.managed:
    - template_name:
        - salt://templates/bgp.jinja
        - salt://templates/ntp.jinja
    - context:
        bpg: {{ pillar.bgp }}
        ntp: {{ pillar.ntp }}
```

### CONNECTION RE-ESTABLISHMENT ON DEMAND
从此版本开始，在NAPALM Proxy Minion下运行时执行的任何NAPALM命令都支持force_reconnect魔术参数。

Proxy Minions通常在Minion启动时与远程网络设备建立连接，并且该连接将永久使用。

如果需要在设备上执行命令但是使用不同的参数进行连接（由于各种原因，例如，无法验证Pillar中指定的用户作为身份验证系统 - 比方说TACACS +不可用，或DNS解析器是目前已关闭并希望暂时使用IP地址等，这意味着需要更新Pillar数据并重新启动Proxy Minion进程重启。 在这种情况下，你可以传递force_reconnect = True关键字参数以及备用连接详细信息，以强制执行通过单独连接执行的命令。

例如，如果通常的命令是salt'*'net.arp，则可以使用以下内容来使用不同的用户名进行连接：
```bash
salt '*' net.arp username=my-alt-usr force_reconnect=True
```
与NAPALM连接所需的任何其他配置参数的使用方法类似 - 请参阅[NAPALM代理文档](https://docs.saltstack.com/en/latest/ref/proxy/all/salt.proxy.napalm.html#module-salt.proxy.napalm)。

### CONFIGURATION REPLACE FEATURES
要替换各种配置块，可以使用新的net.replace_pattern执行函数或netconfig.replace_pattern State函数。 例如，如果要更新配置并重命名在许多位置引用的BGP策略，可以通过运行以下命令来执行此操作：
```bash
salt '*' net.replae_pattern OLD-POLICY-CONFIG new-policy-config
```
同样地，你也可以使用[net.blockreplace](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.napalm_network.html#salt.modules.napalm_network.blockreplace)函数替换整个配置块。

### CONFIGURATION SAVE FEATURES
net.save_config函数可用于将受管设备的配置保存到文件中。 对于State子系统，添加了netconfig.saved函数，该函数在管理可以保存网络设备配置的目标文件时提供完整的工具列表。

例如，在其自己的目录树下备份每个设备的运行配置：
```yaml_utf8
/var/backups/{{ opts.id }}/running.cfg:
  netconfig.saved:
    - source: running
    - makedirs: true
```
上面提到的所有新的网络自动化模块都直接暴露给NAPALM用户，无需任何架构更改，在管理具体网络设备时只需最终按设备系统类型安装一些依赖包：

**1. JUNOS**

现有[junos执行模块](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.junos.html#module-salt.modules.junos)的功能可通过以下函数获得：

- napalm.junos_cli: Execute a CLI command and return the output as text or Python dictionary.
- napalm.junos_rpc: Execute an RPC request on the remote Junos device, and return the result as a Python dictionary, easy to digest and manipulate.
- napalm.junos_install_os: Install the given image on the device.
- napalm.junos_facts: The complete list of Junos facts collected by the junos-eznc underlying library.

>能够使用这些功能，需要确保先满足junos模块的一些依赖性要求。 由于junos-eznc也是NAPALM的依赖项，所以只需要再安装一个jxmlease。详见junos模块说明。

使用样例：
```bash
salt '*' napalm.junos_cli 'show arp' format=xml
salt '*' napalm.junos_rpc get-interface-information
```

**2. NETMIKO**

新添加的[netmiko](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.netmiko_mod.html#module-salt.modules.netmiko_mod)执行模块的功能如下：
- napalm.netmiko_commands: 通过Netmiko执行一个或多个要在远程设备上执行的命令，并将输出作为文本返回。
- napalm.netmiko_config: 通过Netmiko在远程设备上加载一个配置命令的列表。 这些命令既可以从本地，也可以从远程路径加载，通过Salt的模板渲染pipeline传递（默认情况下使用Jinja作为模板渲染引擎）。

使用样例：
```bash
salt '*' napalm.netmiko_commands 'show version' 'show interfaces'
salt '*' napalm.netmiko_config config_file=https://bit.ly/2sgljCB
```

**3. ARISTA PYEAPI**

对于各种操作和各种扩展模块，[pyeapi](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.arista_pyeapi.html#module-salt.modules.arista_pyeapi)模块增加了以下功能：
- napalm.pyeapi_run_commands: Execute a list of commands on the Arista switch, via the pyeapi library.
- napalm.pyeapi_config: Configure the Arista switch with the specified commands, via the pyeapi Python library. Similarly to napalm.netmiko_config, you can use both local and remote files, with or without templating.

使用样例：
```bash
salt '*' napalm.pyeapi_run_commands 'show version' 'show interfaces'
salt '*' napalm.pyeapi_config config_file=salt://path/to/template.jinja
```

**4. CISCO NX-API**

以与上面完全相同的方式，用户可以通过使用以下配置原语通过NX-API管理Cisco Nexus交换机进行完全的控制：
- napalm.nxos_api_show: Execute one or more show (non-configuration) commands, and return the output as plain text or Python dictionary.
- napalm.nxos_api_rpc: Execute arbitrary RPC requests via the Nexus API.
- napalm.nxos_api_config: 使用指定的命令通过NX-API配置Nexus交换机。 可以从命令行或本地或远程文件加载命令，最终使用所选的模板引擎（默认值：jinja）进行渲染。

使用样例：
```bash
salt '*' napalm.nxos_api_show 'show bgp sessions' 'show processes' raw_text=False
```

**5. CISCOCONFPARSE**

在操作Cisco IOS或Junos样式配置时，以下功能列表可能很方便：
- napalm.config_filter_lines: 根据正则表达式匹配得到的其父级和子级节点关系，返回配置块的详细匹配列表。
- napalm.config_find_lines: 返回与提供的正则表达式匹配的配置行。
- napalm.config_lines_w_child: 返回与正则表达式匹配的配置行，且其子行与子正则表达式匹配。
- napalm.config_lines_wo_child: 返回与正则表达式匹配的配置行，且这些配置行没有与子正则表达式匹配的子行。

>这些函数需要安装ciscoconfparse Python库。

使用样例：
```bash
salt '*' napalm.config_lines_w_child 'interface' 'shutdown'
```

**6. IOSCONFIG**

对于Cisco IOS样式配置，在napalm执行模块中添加了以下功能：
- napalm.config_tree: 获取并将Cisco IOS样式配置转换为结构化Python字典。
- napalm.config_merge_tree: 获取受管理设备的配置树，并将其他配置内容合并配置树中（不实际加载设备上的任何更改）。
- napalm.config_merge_text: 获取受管理设备的配置树，并将其他配置内容合并配置树中，将合并后的结果保存为一个文本文件。
- napalm.config_merge_diff: 获取受管理设备的配置树，并将其他配置内容合并配置树中，返回那些有差别的合并内容（不实际加载设备上的任何更改）。

**SCP**

利NAPALM实现的连接与认证，现在还可以使用以下功能：
- napalm.scp_put: 传输文件或文件夹到远程的网络设备上。
- napalm.scp_get: 将文件和目录从远程网络设备传输到Minion的localhost。

### PEERINGDB
[peeringdb](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.peeringdb.html#module-salt.modules.peeringdb)执行模块可用于收集有关可能与你的网络对等的其他网络的信息，并自动建立BGP会话，例如，仅需给定特定的AS号，其余数据（即IP地址，远程网络所在的位置） 从PeeringDB中检索可用的，并且会话配置是自动化的，只需要很少的维护（手动输入IP地址既繁琐又容易出错）。

# NEW DOCKER PROXY MINION
现在可以使用新的docker proxy minion将Docker容器视为实际的minions，而无需在容器中安装salt。

此代理minion使用[docker executor](https://docs.saltstack.com/en/latest/ref/executors/all/salt.executors.docker.html#module-salt.executors.docker)通过[docker.call](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.dockermod.html#salt.modules.dockermod.call)将命令传递到docker容器。 任何状态模块调用都通过[docker模块](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.dockermod.html#module-salt.modules.dockermod)的相应函数传递。

使用样例：
```bash
proxy:
  proxytype: docker
  name: keen_proskuriakova
```
```bash
salt myminion docker.call test.ping
salt myminion test.arg arg1 arg2 key1=val1
salt myminion dockerng.call compassionate_mirzakhani test.arg arg1 arg2 key1=val1
```

# TERRAFORM SALT-SSH ROSTER
现在可以使用[terraform-provider-salt](https://github.com/dmacvicar/terraform-provider-salt)定义的terraform资源动态生成Salt-SSH名册。

这允许结合使用terraform和Salt-SSH来监视和配置主机。 有关如何设置和使用的示例，请参阅[terraform](https://docs.saltstack.com/en/latest/ref/roster/all/salt.roster.terraform.html#module-salt.roster.terraform)列表。

# GRAINS DICTIONARY PASSED INTO CUSTOM GRAINS
从这个版本开始，如果在使用自定义grains函数时接受一个名为grains的变量，那么已经编译过的grains的Grains字典将被传入。由于grains在被渲染时的顺序是不确定的，唯一可以确定且可以被传入的是core.py grains，因为这些是首先编译的。

# MORE PRECISE VIRTUAL GRAIN
在嵌套虚拟化环境（例如VM中的systemd-nspawn容器）中运行Salt并且安装了virt-what时，此版本提高了virtual grain的准确性。

到目前为止，virtual grain是通过匹配virt-what而不是单个项目的所有输出行来确定的，这可能导致不太精确的结果（例如，在基于Hyper-V的VM中运行的systemd-nspawn容器内报告HyperV）。

# CONFIGURABLE MODULE ENVIRONMENT
Salt模块（状态，执行模块，returners等）现在可以在运行shell命令时应用自定义环境变量。 这可以通过在Grains或Pillar中设置系统环境键值对来配置。 语法如下：
```yaml_utf8
system-environment:
  <type>
    <module>:
      # Namespace for all functions in the module
      _:
        <key>: <value>

# Namespace only for particular function in the module
      <function>:
        <key>: <value>
```
- <type\>，是模块的类型（即states，modules等）
- <module\>，是模块名
>模块名称可以是虚拟名称（例如pkg），也可以是物理名称（例如yumpkg）。

- <function\>,是该模块中的函数名称。 要将环境变量应用于给定模块中的所有函数，请使用下划线（即_）作为函数名称。 例如，要为所有包管理函数设置相同的环境变量，可以使用以下内容：

``` yaml_utf8
system-environment:
  modules:
    pkg:
      _:
        SOMETHING: for_all
```

为pkg.install函数设置专有的环境变量：
``` yaml_utf8
system-environment:
  modules:
    pkg:
      install:
        LC_ALL: en_GB.UTF-8
```

设置相同的变量但仅适用于SUSE minions（使用zypper进行包管理）：
```yaml_utf8
system-environment:
  modules:
    zypper:
      install:
        LC_ALL: en_GB.UTF-8
```

> Salt目前还不不是全面的支持此功能; 模块必须要明确的支持此功能才可以（虽然这可能在将来发生变化）。 截至本版本，支持此功能的模块是以下几个pkg虚拟模块：
- aptpkg
- yumpkg
- zypper

# 取消了对在APT中使用"VIRTUAL PACKAGE"的支持
在APT中，一些包具有它们提供的相关联的包列表。 这允许人们在真正的包名为foo1.0时运行apt-get install foo，也能安装上正确的包。

Salt传统上是设计为支持“virtual packages”，它们是由已安装的包提供的，但是没有安装该名称的真实包。 鉴于上面的示例，如果要为名为foo的包运行pkg.installed状态，那么pkg.list_pkgs将为包foo显示为1的包版本，表示它是virtual package。

然而，虽然这使得包管理的某些方面变得方便，但是这种方法的问题使得依赖于“virtual packages”成为问题。 例如，Ubuntu为nginx提供了四种不同的相互冲突的包：
- nginx-core
- nginx-full
- nginx-light
- nginx-extras

所有这四个都提供了nginx。 然而，还有一个名为nginx的包，它没有实际内容，只依赖于上述四个包中的任何一个。 如果在pkg.installed状态下使用了nginx，并且没有安装上述四个软件包，那么将安装nginx元数据包，这将引入nginx-core_。 稍后，如果在pkg.removed状态下使用nginx，则将删除nginx元数据包，并保留nginx-core。 结果是，由于nginx-core_提供了nginx_，Salt现在将nginx视为已安装的一个virtual package，pkg.removed state将会失败。 此外，实际上不会删除nginx，因为nginx-core将保持安装状态。

从此版本开始，Salt将不再支持在pkg状态中使用“virtual packages”名称，并且需要使用正确的包名指定包名称。 在给定包名（或glob）的情况下，pkg.list_repo_pkgs函数可用于在存储库中查找匹配的包名：
```bash
# salt myminion pkg.list_repo_pkgs 'nginx*'
myminion:
    ----------
    nginx:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-common:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-core:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-core-dbg:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-doc:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-extras:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-extras-dbg:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-full:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-full-dbg:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-light:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
    nginx-light-dbg:
        - 1.10.3-0ubuntu0.16.04.2
        - 1.9.15-0ubuntu1
```

或者，新添加的pkg.show函数可用于获取有关给定包的更多详细信息，并帮助确定哪个包名称正确：
```bash
# salt myminion pkg.show 'nginx*' filter=description,provides
myminion:
    ----------
    nginx:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                small, powerful, scalable web/proxy server
        1.9.15-0ubuntu1:
            ----------
            Description:
                small, powerful, scalable web/proxy server
    nginx-common:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                small, powerful, scalable web/proxy server - common files
        1.9.15-0ubuntu1:
            ----------
            Description:
                small, powerful, scalable web/proxy server - common files
    nginx-core:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (core version)
            Provides:
                httpd, httpd-cgi, nginx
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (core version)
            Provides:
                httpd, httpd-cgi, nginx
    nginx-core-dbg:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (core version) - debugging symbols
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (core version) - debugging symbols
    nginx-doc:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                small, powerful, scalable web/proxy server - documentation
        1.9.15-0ubuntu1:
            ----------
            Description:
                small, powerful, scalable web/proxy server - documentation
    nginx-extras:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (extended version)
            Provides:
                httpd, httpd-cgi, nginx
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (extended version)
            Provides:
                httpd, httpd-cgi, nginx
    nginx-extras-dbg:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (extended version) - debugging symbols
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (extended version) - debugging symbols
    nginx-full:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (standard version)
            Provides:
                httpd, httpd-cgi, nginx
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (standard version)
            Provides:
                httpd, httpd-cgi, nginx
    nginx-full-dbg:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (standard version) - debugging symbols
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (standard version) - debugging symbols
    nginx-light:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (basic version)
            Provides:
                httpd, httpd-cgi, nginx
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (basic version)
            Provides:
                httpd, httpd-cgi, nginx
    nginx-light-dbg:
        ----------
        1.10.3-0ubuntu0.16.04.2:
            ----------
            Description:
                nginx web/proxy server (basic version) - debugging symbols
        1.9.15-0ubuntu1:
            ----------
            Description:
                nginx web/proxy server (basic version) - debugging symbols
```

# MINION STARTUP EVENTS
当一个minion启动时，它会在事件总线上发送一个通知，其标签如下所示：salt/minion/<minion_id>/start。 由于历史原因，minion还发送了一个类似的事件，其中包含如下事件标记：minion_start。 当有许多小兵时，这种重复可能会在事件总线上造成很多混乱。 在minion配置中设置enable_legacy_startup_events：False以确保仅发送salt/minion/<minion_id>/start事件。

新的enable_legacy_startup_events minion配置选项默认为True，但从Salt的Sodium版本开始将默认设置为False。

Salt Syndic目前也发送旧式的syndic_start事件。 syndic也支持enable_legacy_startup_events选项。

# FAILHARD CHANGES
现在可以使用一个state-level failhard设置来覆盖全局的failhard设置。 这在全局failhard设置为True时，可以允许你通过将state级别failhard设置为False，而不会因为可能发生失败的特定state状态而影响到全局上的整体停止执行。 这也允许使用onfail*-requisites，这在以前全局failhard设置为True时会被忽略。 这会与以前的行为有所偏差，在以前全局failhard设置总是会在任何状态执行失败时立即停止下来（无论失败状态是否具有自己的失败设置，或者是否使用了任何onfail*-requisites）。

# PASS THROUGH OPTIONS TO FILE.SERIALIZE STATE
这允许更精细地控制数据集序列化的方式。 有关详细信息，请参阅[file.serialize](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.file.html#salt.states.file.serialize)状态中有关新serializer_opts和deserializer_opts选项的文档。

# FILE.PATCH STATE REWRITTEN
file.patch状态已被重写并补充了几个新功能：
- 补丁源现在可以是远程文件，而不仅仅是salt://URL
- 现在支持多文件的修补程序
- 补丁文件也可以支持模板化
此外，不再需要指定patched file的哈希值。

# NEW NO_PROXY MINION CONFIGURATION
支持使用no_proxy minion配置选项传递一个需要绕过HTTP代理的主机列表。

>除非同时也配置了proxy_host，否则此配置选项不会执行任何操作。并且它不支持任何类型的通配符。

```yaml_utf8
no_proxy: [ '127.0.0.1', 'foo.tld' ]
```

# CHANGES TO SLACK ENGINE
使用Salt [Slack](https://docs.saltstack.com/en/latest/ref/engines/all/salt.engines.slack.html#module-salt.engines.slack)引擎运行的功能函数，返回给Slack的输出现在可以使用该函数的正确输出器进行格式化。 早期的版本中会在YAML中为所有函数做统一的格式化输出，除了正在运行的状态。

# ENHANCEMENTS TO WTMP BEACON
Linux系统中都会将系统用户登录、登出信息保存在/var/log/wtmp的一个文件中，在系统中一般可以使用last命令查看。

Salt WTMP Beacon功能正是提供了通过Salt侦听和管理目标主机系统用户登录行为的功能。

新版本中为此信标触发的事件中添加了一个新的键——action，它将包含字符串login或logout。 这将简化使用此信标数据的reactors，因为不再需要检查type键的整数值以了解事件是登录还是注销行为了。

此外，如果在你的平台中使用的是非标准的utmp.h，那么现在可以支持配置哪些类型编号表示登录和注销。

有关更多信息，请参阅[wtmp beacon](https://docs.saltstack.com/en/latest/ref/beacons/all/salt.beacons.wtmp.html#module-salt.beacons.wtmp)文档。

# DEPRECATIONS - 不再支持的一些功能
## API DEPRECATIONS
已删除对[LocalClient](https://docs.saltstack.com/en/latest/ref/clients/index.html#local-client)的expr_form参数的支持。 请改用tgt_type。 此更改是由于社区成员报告说在使用中经常会发生混淆，而使用tgt_type定位目标主机发布到minions时，在作业缓存中也会显示为tgt_type，这样会更加清晰且一致。

那些使用LocalClient 旧参数（直接本地调用或通过[netapi](https://docs.saltstack.com/en/latest/ref/netapi/all/index.html#all-netapi-modules)模块隐式调用）的人需要更新他们的代码以使用tgt_type。
```yaml_utf8
>>> import salt.client
>>> local = salt.client.LocalClient()
>>> local.cmd('*', 'cmd.run', ['whoami'], tgt_type='glob')
{'jerry': 'root'}
```

## MINION CONFIGURATION DEPRECATIONS - 弃用的一些minion配置选项
自2019.2.0发行版起，不推荐使用master_shuffle配置选项。 请改用random_master选项。

## MODULE DEPRECATIONS - 弃用的一些Salt modules
-  [napalm_network](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.napalm_network.html#module-salt.modules.napalm_network) 模块有做以下的变更：
 - 已从net.load_template函数中移除了对template_path的支持。 这是因为已删除对NAPALM本机模板的支持。
- [pip](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.pip.html#module-salt.modules.pip)模块有做以下的变更：
 - 已从pip.install函数中删除对no_chown选项的支持。
- [trafficserver](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.trafficserver.html#module-salt.modules.trafficserver)模块有做以下的变更：
 - trafficserver.match_var函数已被删除。 请改用trafficserver.match_metric。
 - trafficserver.read_var函数已被删除。 请改用trafficserver.read_config。
 - trafficserver.set_var函数已被删除。 请改用trafficserver.set_config。
- win_update模块已被删除。 它已被win_wua取代。
- win_update模块有做以下的变更：
 - win_wua.download_update和win_wua.download_updates函数已被删除。 请改用win_wua.download。
 - win_wua.install_update和win_wua.install_updates函数已被删除。 请改用win_wua.install。
 - win_wua.list_update函数已被删除。 请改用win_wua.get。
 - win_wua.list_updates函数已被删除。 请改用win_wua.list。

## PILLAR DEPRECATIONS
 -  [vault](https://docs.saltstack.com/en/latest/ref/pillar/all/salt.pillar.vault.html#module-salt.pillar.vault) external pillar有做以下的变更：
  - 删除了对profile参数的支持。 在第一个"path=""之前和之后传递的任何选项都将被丢弃。

## ROSTER DEPRECATIONS
- cache roster模块有做以下的变更：
 - 已删除对roster_order作为列表或元组的支持。 截至2019.2.0版本，roster_order必须是字典。
 - roster_order选项现在除了IPv4之外还包括用于私有，公共，全局或本地设置的IPv6。 这些设置的语法分别更改为ipv4-*或ipv6-*。

## STATE DEPRECATIONS
- docker state模块被移除了
 -  在2017.7.0中，该模块中的状态分为四个独立的state模块：
   - [docker_container](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.docker_container.html#module-salt.states.docker_container)
   - [docker_image](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.docker_image.html#module-salt.states.docker_image)
   - [docker_volume](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.docker_volume.html#module-salt.states.docker_volume)
   - [docker_network](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.docker_network.html#module-salt.states.docker_network)
 - 为了向后兼容性，docker模块仍保留，但现在已被删除。 请更新SLS文件以使用新的state名称：
   -  docker.running => docker_container.running
    - docker.stopped => docker_container.stopped
   -  docker.absent => docker_container.absent
    - docker.network_present => docker_network.present
    - docker.network_absent => docker_network.absent
    - docker.image_present => docker_image.present
    - docker.image_absent => docker_image.absent
    - docker.volume_present => docker_volume.present
    - docker.volume_absent => docker_volume.absent
- docker_network模块有做以下的变更：
 - 已从docker_network.absent中删除了driver选项。 它没有任何功能，因为状态只是删除指定的网络名称（如果存在的话）。
- 已弃用的ref选项已从[git.detached](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.git.html#salt.states.git.detached)状态中删除。 请改用rev。
- 已删除k8s状态模块以支持更加通用的[kubernetes](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.kubernetes.html#module-salt.states.kubernetes)状态模块。 请按如下方式更新SLS文件：
 - In place of k8s.label_present, use kubernetes.node_label_present
 - In place of k8s.label_absent, use kubernetes.node_label_absent
 - In place of k8s.label_folder_absent, use kubernetes.node_label_folder_absent
- 已删除对netconfig.managed <salt.states.netconfig.managed（）状态中的template_path选项的支持。 这是因为已删除对NAPALM本机模板的支持。
- 已删除对pip.installed状态中no_chown选项的支持。
- trafficserver.set_var状态已被删除。 请改用trafficserver.config。
- 已删除对:py:func`virtualenv.managed <salt.states.virtualenv.managed>`函数中no_chown选项的支持。
- 已删除win_update状态模块。 它已被win_wua取代。
- 从py:mod:pkg state <salt.states.pkg>中移除了对virtual packages的支持。

## UTILS DEPRECATIONS
- cloud util模块有做以下的变更：
 - 已删除对salt utils模块中cache_nodes_ip函数的支持。 该功能不完整。
- vault util模块有做以下的变更：
 - 已删除对在一个“profile”配置中指定Vault连接参数的支持。 有关新配置架构的详细信息，请参阅[Vault execution module](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.vault.html#module-salt.modules.vault)文档。

## DEPENDENCY DEPRECATIONS
Salt-Cloud已更新为使用pypsexec Python库而不是winexe可执行文件。 winexe和pypsexec都针对Windows操作系统运行远程命令。 由于winexe并未针对每个系统进行打包，因此推荐使用pypsexec。

Salt-Cloud已经弃用了impacket，改为使用smbprotocol。 之所以进行此更改，是因为impacket与Python3不兼容。

# SALTSSH MAJOR UPDATES
SaltSSH现在适用于多个主要的Python版本。 可以透明地支持Python 2.7~Python 3.x. 但是，这要求SaltMaster应该安装Salt包括Python2和Python3的所有相关依赖项。所有内容都需要从相应的Python环境中导入。

SaltSSH可以捆绑到任意版本的Salt。 例如，如果有一个旧设备，在运行过时且不受支持的Python 2.6，仍然可以从使用Python 3.5或更高版本的SaltMaster访问它。 此功能需要在/etc/salt/master中进行其他配置，如下所示：
```yaml_utf8
ssh_ext_alternatives:
    2016.3:                     # Namespace, can be actually anything.
        py-version: [2, 6]      # Constraint to specific interpreter version
        path: /opt/2016.3/salt  # Main Salt installation
        dependencies:           # List of dependencies and their installation paths
          jinja2: /opt/jinja2
          yaml: /opt/yaml
          tornado: /opt/tornado
          msgpack: /opt/msgpack
          certifi: /opt/certifi
          singledispatch: /opt/singledispatch.py
          singledispatch_helpers: /opt/singledispatch_helpers.py
          markupsafe: /opt/markupsafe
          backports_abc: /opt/backports_abc.py
```
也可以使用几种替代版本的Salt。 例如，您可以使用runners生成最小的tarball并包含它。 但这是唯一可能的，仅当Master主机上也有这种特定的Salt版本时，虽然不需要与旧的Python解释器一起直接安装。

SaltSSH现在支持私钥密码。 您可以通过以下方式对其进
- --priv-passwd for salt-ssh cli
- salt_priv_passwd for salt master configure file
- priv_passwd for salt roster file

# STATE MODULE CHANGES
## [salt](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.saltmod.html#module-salt.states.saltmod) STATE MODULE (USED IN ORCHESTRATION)
现在，test选项默认为None。 此处设置的True或False值将传递给正在运行的状态，并可用于覆盖在minion的配置文件中设置的test:True选项。 在以前的版本中，minion的配置选项优先，在配置文件中已经将测试模式设置为True的minion上运行编排是不可能的。

如果minion在配置文件未设置为处于永久测试模式，并且此处的'test'参数保留为None，那么在命令行上使用的test=True值将正确传递给minion以在测试模式下运行编排。 目前，无法在命令行上传递test=False，对已经设置为永久测试模式下的minion进行变更，因此仍必须在编排文件中设置test：False选项。

## [EVENT.SEND](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.event.html#salt.states.event.send) STATE
event.send状态不知道发送事件的结果，因此每次运行状态都会返回更改。 现在可以设置为返回已更改或未更改。

## [INFLUXDB_USER.PRESENT](https://docs.saltstack.com/en/latest/ref/states/all/salt.states.influxdb_user.html#module-salt.states.influxdb_user) INFLUXDB USER MODULE STATE
password参数已更改为passwd以消除与Influxdb客户端配置（client_kwargs）的名称混淆，这用于允许在Influxdb实例上启用身份验证时管理用户。

Old behavior:
```yaml_utf8
influxdb_user.present:
  - name: exampleuser
  - password: exampleuserpassword
  - user: admin
  - password: adminpassword
```

New behavior:
```yaml_utf8
influxdb_user.present:
  - name: exampleuser
  - passwd: exampleuserpassword
  - user: admin
  - password: adminpassword
```

## [WINREPO_CACHE_EXPIRE_MIN](https://docs.saltstack.com/en/latest/ref/configuration/minion.html#std:conf_minion-winrepo_cache_expire_min) WINDOWS PACKAGE DEFINITIONS CACHING
winrepo_cache_expire_min已从0更改为1800（30分钟）例如，如果运行highstate，则包定义通常会更新，但是现在如果包定义比winrepo_cache_expire_min（30分钟）更年轻，则package definitions将不会刷新，从而减少了运行第二次highstate所需的时间。 要继续使用旧功能，请在minion配置文件中将值更改回0。 这也会影响默认刷新的其他函数的行为。 pkg.refresh_db将始终刷新包定义。

## LDAP EXTERNAL AUTHENTICATION
**FREEIPA GROUPATTRIBUTE SUPPORT**

以前，如果Salt对freeipa LDAP系统使用外部身份验证，则只能通过accountattributename字段搜索用户。 此版本还使用groupattribute字段添加其他搜索支持。 原始accountattributename搜索首先完成，然后是groupattribute，允许向后兼容以前的Salt版本。

## JINJA INCLUDE RELATIVE PATHS
当jinja包含模板名称以./或../开头时，将使用相对路径寻找并导入文件。

先前的实践中是按下面的样子定义的：
```yaml_utf8
{% from tpldir ~ '/foo' import bar %}
```
现在可以使用一个更自然的方式：
```yaml_utf8
{% from './foo' import bar %}
```
从父目录导入时 - 先前的做法是：
```YAML
{% from tpldir ~ '/../foo' import bar %}
```
使用新的样式来导入父目录中的文件：
```yaml_utf8
{% from '../foo' import bar %}
```

# SALT-API
**SALT-API WINDOWS SUPPORT**

以前，Microsoft Windows平台不支持salt-api。 现在它支持了！ salt-api为正在运行的Salt系统提供RESTful接口。 它允许通过REST API访问minions、runners和jobs以及通过正在运行的Salt系统的执行execution modules 和 runners，返回JSON格式的输出结果。 请参阅Salt-API文档。 .. _Salt-API：https://docs.saltstack.com/en/latest/topics/netapi/index.html

# LOGGING CHANGES
**INCLUDE JOB ID (JID) IN MINION AND MASTER LOGS**

通过在log_fmt_console或log_fmt_logfile配置选项中包含jid，现在可以选择将作业ID（JID）包含在minion和master日志中：
```yaml_utf8
log_fmt_console: "[%(levelname)-8s] %(jid)s %(message)s"
```
这将导致JID被包含在与特定Salt作业相关的任何日志条目中。 JID信息将使用默认格式[JID：％（jid）s]，但也可以使用log_fmt_jid配置项自定义：
```yaml_utf8
log_fmt_jid: "[JID: %(jid)s]"
```

# SECURITY
**WINDOWS RUNAS CHANGES**

在正常情况下，runas不再需要密码。 只有当minion进程在受限（非管理员）帐户下运行时，才需要使用密码选项。 在上述情况下，只有在使用runas参数以不同用户身份运行命令时才需要密码。

# NEW MODULES
## EXECUTION MODULES
- [salt.modules.ciscoconfparse_mod](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.ciscoconfparse_mod.html#module-salt.modules.ciscoconfparse_mod)
- [salt.modules.jira](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.jira_mod.html#module-salt.modules.jira_mod)
- [salt.modules.google_chat](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.google_chat.html#module-salt.modules.google_chat)
- [salt.modules.iosconfig](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.iosconfig.html#module-salt.modules.iosconfig)
- [salt.modules.netmiko](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.netmiko_mod.html#module-salt.modules.netmiko_mod)
- [salt.modules.nxos_api](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.nxos_api.html#module-salt.modules.nxos_api)
- [salt.modules.peeringdb](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.peeringdb.html#module-salt.modules.peeringdb)
- [salt.modules.purefb](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.purefb.html#module-salt.modules.purefb)
- [salt.modules.pyeapi](https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.arista_pyeapi.html#module-salt.modules.arista_pyeapi)

## PILLAR MODULES
- [netbox](https://docs.saltstack.com/en/latest/ref/pillar/all/salt.pillar.netbox.html#module-salt.pillar.netbox)

## PROXY MODULES
- [salt.proxy.netmiko](https://docs.saltstack.com/en/latest/ref/proxy/all/salt.proxy.netmiko_px.html#module-salt.proxy.netmiko_px)
- [salt.proxy.nxos_api](https://docs.saltstack.com/en/latest/ref/proxy/all/salt.proxy.nxos_api.html#module-salt.proxy.nxos_api)
- [salt.proxy.pyeapi](https://docs.saltstack.com/en/latest/ref/proxy/all/salt.proxy.arista_pyeapi.html#module-salt.proxy.arista_pyeapi)

---

*Finished*

wyaopeng/SaltStack-Chinese-ManualBook

简介

发行版

贡献者

近期动态

wyaopeng/SaltStack-Chinese-ManualBook .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

wyaopeng/SaltStack-Chinese-ManualBook