SCP

Apache Ant 1.6以降

説明

SSHデーモンが動作している（リモート）マシンとの間で、ファイルまたはFileSetをコピーします。FileSetは、ローカルマシンからリモートマシンへのファイルのコピーのみに有効です。

注意: このタスクは、Antディストリビューションに含まれていない外部ライブラリに依存しています。詳細については、ライブラリの依存関係を参照してください。このタスクは、jsch-0.1.2以降でテストされています。

sshexecタスクも参照してください

パラメータ

ネストされた要素として指定されたパラメータ

リソースコレクション

FileSetまたはその他のリソースコレクションを使用して、コピーするファイルのグループを選択します。filesetまたはリソースコレクションを使用するには、todir属性を設定する必要があります。

Ant 1.9.7より前は、ネストされた要素として<fileset>のみがサポートされていました。

additionalConfig

Ant 1.10.10以降

特定のAnt属性で直接サポートされていない、作成されたJSchセッションの構成設定を追加します。

例

単一のローカルファイルをリモートマシンにコピーする

<scp file="myfile.txt" todir="user:password@somehost:/home/chuck"/>

別々のpassword属性を使用して、単一のローカルファイルをリモートマシンにコピーする

<scp file="myfile.txt" todir="user@somehost:/home/chuck" password="password"/>

キーベース認証を使用して、単一のローカルファイルをリモートマシンにコピーする

<scp file="myfile.txt"
     todir="user@somehost:/home/chuck"
     keyfile="${user.home}/.ssh/id_dsa"
     passphrase="my extremely secret passphrase"/>

単一のリモートファイルをローカルディレクトリにコピーする

<scp file="user:password@somehost:/home/chuck/myfile.txt" todir="../some/other/dir"/>

リモートディレクトリをローカルディレクトリにコピーする

<scp file="user:password@somehost:/home/chuck/*" todir="/home/sara"/>

ローカルディレクトリをリモートディレクトリにコピーする

<scp todir="user:password@somehost:/home/chuck/">
  <fileset dir="src_dir"/>
</scp>

ファイルのセットをディレクトリにコピーする

<scp todir="user:password@somehost:/home/chuck">
  <fileset dir="src_dir">
    <include name="**/*.java"/>
  </fileset>
</scp>

ファイルのセットをリモートディレクトリに最終更新日の逆順でコピーする

<scp todir="user:password@somehost:/home/chuck">
  <sort>
    <reverse>
      <date/>
    </reverse>
    <fileset dir="src_dir">
      <include name="**/*"/>
    </fileset>
  </sort>
</scp>

セキュリティに関する注意: scpタスクでパスワードやユーザー名をハードコーディングすることは、深刻なセキュリティホールになる可能性があります。変数置換を使用して、コマンドラインにパスワードを含めることを検討してください。例：

<scp todir="${username}:${password}@host:/dir" ...>

次のコマンドラインでAntを起動する

ant -Dusername=me -Dpassword=mypassword target1 target2

少しはマシですが、ユーザー名/パスワードはUnixシステム上のすべてのユーザーに（psコマンド経由で）公開されます。最善のアプローチは、<input>タスクを使用するか、保護された.propertiesファイルからパスワードを取得することです。

Unixに関する注意: ファイルのアクセス許可は、ファイルのダウンロード時に保持されません。代わりに、デフォルトのUMASKアクセス許可で終了します。これは、現在のJavaランタイムでファイルアクセス許可をクエリまたは設定する手段がないことが原因です。アクセス許可を保持するコピー機能が必要な場合は、代わりに<exec executable="scp" ... >を使用してください。