Uploading artifacts
===================

``artifacts``
を定義して、ファイルをターゲットインスタンスに作成またはコピーできます。

.. code:: yaml

   cluster_vars:
     artifacts:
     - type: path
       path: /some/target/path
       state: directory
       owner: root
       group: root
       mode: "0755"
     - type: file
       src: /host/path/to/file
       dest: /target/path/to/file
       owner: root
       group: root
       mode: "0644"
     - type: archive
       src: example.tar.gz
       dest: /some/target/path
     - type: directory
       src: /host/path/a/
       dest: /target/path/b/

次のタイプがサポートされています。

- ``path``
  を使用して、ファイルとディレクトリの所有権またはモードを作成または削除、および変更します内部で使用するAnsibleの\ ``file``
  モジュールと同じパラメーターを取得します

- ``file``
  を使用してコントローラからファイルをコピーし、所有権とモードを設定します
  ``copy`` を使用

- ``archive``
  を使用して、アーカイブから指定した場所にファイルを抽出します
  ``unarchive`` を使用

- ``directory``
  を使用して、コントローラからターゲットインスタンスにディレクトリをr同期します
  ``synchronize`` を使用

この例では、上記のアーティファクトタイプごとに1つのエントリーを示していますが、これらのパラメーター、または対応するAnsibleモジュールが受け入れるその他のパラメーターを使用できます。

ファイルとディレクトリのターゲットインスタンスへのコピーは、十分な一般的なニーズであるため、この機能は
:ref:`TPA hooks <TPA hooks>` 
を書き込む代わりに使用できる便利なショートカットを提供します。