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:`custom hook <TPA hooks>` 
を書き込む代わりに使用できる便利なショートカットを提供します。