step 1: understand salt returners 了解salt returners

Before you configure a job cache, it is essential to understand Salt returner modules ("returners"). Returners are pluggable Salt Modules that take the data returned by jobs, and then perform any necessary steps to send the data to an external system. For example, a returner might establish a connection, authenticate, and then format and transfer data.

在配置job cache之前，了解Salt returner 模块("returners")是绝对有必要的。Returners 是可插拔的Salt模块，它接收作业返回的数据，然后执行任何必要的步骤将数据发送到外部系统。例如，返回者可以建立连接、认证、然后格式化和传输数据。

The Salt Returner system provides the core functionality used by the External and Master Job Cache systems, and the same returners are used by both systems.

Salt Returnner系统提供External和Master Job Cache系统所使用的核心功能，并且两个系统都使用相同的returnners。

Salt currently provides many different returners that let you connect to a wide variety of systems. A complete list is available at all Salt returners. Each returner is configured differently, so make sure you read and follow the instructions linked from that page.

Salt目前提供了许多不同的returners, 让你连接到各种各样的系统。所有Salt returners都有一份完整的清单。每个return的配置不同，所以请务必阅读并遵循从该页面链接的指令。

For example, the MySQL returner requires: 比如，MySQL returnner的规定：

• A database created using provided schema (structure is available at MySQL returner)
• A user created with privileges to the database
• Optional SSL configuration

A simpler returner, such as Slack or HipChat, requires:

• An API key/version
• The target channel/room
• The username that should be used to send the message

step 2: configure the returner

After you understand the configuration and have the external system ready, the configuration requirements must be declared.

在了解配置并使外部系统准备好之后，必须声明配置要求。

mysql.host: 'salt'
mysql.user: 'salt'
mysql.pass: 'salt'
mysql.db: 'salt'
mysql.port: 3306

slack.channel: 'channel'
slack.api_key: 'key'
slack.from_name: 'name'

ext_job_cache: <returner>

ext_job_cache: mysql

注意：
When configuring an External Job Cache (Minion-side), the returner settings are added to the Minion configuration file, but the External Job Cache setting is configured in the Master configuration file.
当配置 External Job Cache (Minion-side)时，将returner设置添加到 Minion配置文件中，但 External Job Cache设置在Master配置文件中配置。

master_job_cache: <returner>

master_job_cache: mysql