salt-key命令介绍

"saltstack学习五"

Posted by Jht on September 29, 2016

salt-key命令介绍

英文水平一版,列位凑合看。

#运行
salt-key -h

Options

Options:
  --version             显示版本号
  --versions-report     显示程序的所有依赖包版本号
  -h, --help            帮助信息
  --saltfile=SALTFILE   指定Saltfile. 如果不合法, 在当前工作目录中查找.
  #文件内容
  #salt-key:
  #config_dir: /home/vagrant/salt-key
  #log_file: /home/vagrant/salt-key/log.txt
  -c CONFIG_DIR, --config-dir=CONFIG_DIR
                        Salt配置目录的位置。这个目录包含了Salt Master和Minion的配置文件。在大多数系统中,默认位置是``/etc/salt``-u USER, --user=USER  指定用户运行salt-key.
  --hard-crash          捕捉original异常不退出,默认:False
  -q, --quiet           安静模式,不输出信息到控制台
  -y, --yes             对所有询问是否继续,回答yes,默认:False
  --rotate-aes-key=ROTATE_AES_KEY
                        设置成false,将使删除掉的minios还监听master发布的消息。慎用。默认:True

Actions

Actions:
  -l ARG, --list=ARG      
                        打印公钥key. 可设置下面三个值
                        "pre", "un", and "unaccepted" 会显示 不许可/未签名 keys. 
                        "acc" or "accepted"会显示 许可/已签名 keys. 
                        "rej" or "rejected"会显示拒绝的 keys.  
                        "all" 会显示所有 keys.
  -L, --list-all        会显示所有公钥,相当月: "--list all"
  -a ACCEPT, --accept=ACCEPT 
                        许可指定的公钥(使用--include-all选项
                        可以指定除了挂起的key外的所有reject状态的公钥)
  -A, --accept-all      接受所有等待认证的key
  -r REJECT, --reject=REJECT 
                        拒绝指定的公钥 (使用--include-all选项
                        可以指定除了挂起的key外的所有accept状态的公钥)
  -R, --reject-all      拒绝所有等待认证的key
  --include-all         显示所有状态的key,配合 accepting/rejecting 选项使用,指定所有非pending状态的公钥
  -p PRINT, --print=PRINT 
                        打印指定的公钥
  -P, --print-all       打印所有的公钥
  -d DELETE, --delete=DELETE 
                        删除指定key
  -D, --delete-all      删除所有的key
  -f FINGER, --finger=FINGER 
                        显示指定key的指纹信息
  -F, --finger-all      显示所有key的指纹信息

Logging Options

Logging Options
  --log-file=LOG_FILE
                        指定日志文件路径,默认: /var/log/salt/key.
  --log-file-level=LOG_LEVEL_LOGFILE
                        日志文件等级,可设置下面中的一个值 'all', 'garbage',
                        'trace', 'debug', 'info', 'warning', 'error', 'quiet'.
                        默认: 'warning'.

Output Options

Output Options:
    Configure your preferred output format.

    --out=OUTPUT, --output=OUTPUT
                        指定输出的格式, The builtins are 'key', 'yaml',
                        'overstatestage', 'highstate', 'newline_values_only',
                        'txt', 'raw', 'no_return', 'virt_query', 'compact',
                        'json', 'nested', 'quiet', 'pprint'.
    --out-indent=OUTPUT_INDENT, --output-indent=OUTPUT_INDENT
                        设置输出行缩进的空格数. 
                        负数取消输出缩进编排.仅对使用的outputer有效.
    --out-file=OUTPUT_FILE, --output-file=OUTPUT_FILE
                        把显示输出到指定的文件
    --out-file-append, --output-file-append
                        把显示输出添加到指定的文件
    --no-color, --no-colour
                        关闭字体颜色
    --force-color, --force-colour
                        强制开启输出颜色渲染
    --state-output=STATE_OUTPUT, --state_output=STATE_OUTPUT
                        覆盖掉master配置文件中对minion 返回输出内容所定义的state_output值。针对本次命令起效。One of 'full', 'terse', 'mixed', 'changes' or
                        'filter'. Default: 'none'.
    --state-verbose=STATE_VERBOSE, --state_verbose=STATE_VERBOSE
                        覆盖掉master配置文件中对minion 返回输出内容所定义的state_verbose值, 针对本次命令起效。 Set to True or False. Default: none.

Key Generation Options

Key Generation Options:

    --gen-keys=GEN_KEYS
                        生成的key设置一个salt使用的名称
                        #salt-key --gen-keys=minibar
                        #会生成
                        #minibar.pem minibar.pub
    --gen-keys-dir=GEN_KEYS_DIR
                        设置生成key对的放置目录,默认当前目录。 Default: '.'.
    --keysize=KEYSIZE   生成key设置位数, 仅跟--gen-keys选项配合时有效,
                        数值大小必须大于2048,否则会被提升至2048位,
                        Default: 2048.
    --gen-signature     Create a signature file of the masters public-key
                        named master_pubkey_signature. The signature can be
                        send to a minion in the masters auth-reply and enables
                        the minion to verify the masters public-key
                        cryptographically. This requires a new signing-key-
                        pair which can be auto-created with the --auto-create
                        parameter.看下方示例。
    --priv=PRIV         The private-key file to create a signature with.
    --signature-path=SIGNATURE_PATH
                        The path where the signature file should be written.
    --pub=PUB           The public-key file to create a signature for.
    --auto-create       Auto-create a signing key-pair if it does not yet
                        exist.
    #运行
    #salt-key --auto-create --gen-signature
    #Generating new signing key-pair master_sign.* in /etc/salt/pki/master
    #Using public-key /etc/salt/pki/master/master.pub
    #Using private-key /etc/salt/pki/master/master_sign.pem