AzureFileCopy@2 - Azure ファイル コピー v2 タスク
Azure Blob Storage または仮想マシンにファイルをコピーします。
このバージョンの AzureFileCopy タスクでは廃止されたバージョンの AzCopy が使用されるため、このタスクは非推奨になりました。 最新バージョンの AzureFileCopy タスクを使用します。 v8 v10の AzCopy 移行ガイドを参照してください。
注
このタスクでは、ワークフロー ID フェデレーション を使用した Azure Resource Manager 認証はサポートされていません。
Azure Blob Storage または仮想マシンにファイルをコピーします。
注
このタスクでは、ワークフロー ID フェデレーション を使用した Azure Resource Manager 認証はサポートされていません。
構文
# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
inputs:
SourcePath: # string. Required. Source.
#azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
#azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription.
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription.
Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type.
#classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account.
storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account.
#ContainerName: # string. Required when Destination = AzureBlob. Container Name.
#BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix.
#cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service.
#resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
#MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria.
#vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login.
#vmsAdminPassword: # string. Required when Destination = AzureVMs. Password.
#TargetPath: # string. Required when Destination = AzureVMs. Destination Folder.
#AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob).
#AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM).
#enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
#CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
#CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
#skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
# Output
#outputStorageUri: # string. Storage Container URI.
#outputStorageContainerSasToken: # string. Storage Container SAS Token.
入力
SourcePath
-
ソース
string. 必須。
ソース フォルダー、ローカル コンピューター上のファイル、または UNC 共有への絶対パスを指定します。 指定した値または式は、単一のフォルダー名またはファイル名を返す必要があります。
azureConnectionType
-
Azure 接続の種類の
入力エイリアス: ConnectedServiceNameSelector。
string. 使用できる値: ConnectedServiceName (Azure クラシック)、ConnectedServiceNameARM (Azure Resource Manager)。 既定値: ConnectedServiceNameARM.
Azure 接続の種類を指定します。
Azure クラシック サブスクリプションの azureClassicSubscription -
入力エイリアス: ConnectedServiceName。
string.
ConnectedServiceNameSelector = ConnectedServiceNameする場合に必要です。
ターゲットの Azure クラシック サブスクリプションを指定します。
Azure サブスクリプションの azureSubscription -
入力エイリアス: ConnectedServiceNameARM。
string.
ConnectedServiceNameSelector = ConnectedServiceNameARMする場合に必要です。
ターゲットの Azure Resource Manager サブスクリプションを指定します。
Destination
-
変換先の種類の
string. 必須。 使用できる値: AzureBlob (Azure BLOB)、AzureVMs (Azure VM)。
ファイルのコピーに使用するコピー先の種類を指定します。
クラシック ストレージ アカウントの classicStorage -
入力エイリアス: StorageAccount。
string.
ConnectedServiceNameSelector = ConnectedServiceNameする場合に必要です。
既存のクラシック ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。
RM ストレージ アカウントの storage -
入力エイリアス: StorageAccountRM。
string.
ConnectedServiceNameSelector = ConnectedServiceNameARMする場合に必要です。
既存の ARM ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。
ContainerName
-
コンテナー名の
string.
Destination = AzureBlobする場合に必要です。
ファイルのコピー先となるコンテナーの名前を指定します。 指定したコンテナーがストレージ アカウントに存在しない場合は、作成されます。
コンテナー内に仮想ディレクトリを作成するには、BLOB プレフィックス入力を使用します。 たとえば、ターゲットの場所 https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/の場合は、コンテナー名の mycontainer と BLOB プレフィックスの vd1/vd2を指定します。
BlobPrefix
-
BLOB プレフィックスの
string. 任意
Destination = AzureBlobするときに使用します。
ファイルのフィルター処理に使用できるプレフィックスを指定します。
例: ビルド番号を追加して、すべての BLOB のファイルを同じビルド番号でフィルター処理できます。
例: myvd1BLOB プレフィックスを指定すると、コンテナー内に仮想ディレクトリが作成されます。 ファイルはソースから https://myaccount.blob.core.windows.net/mycontainer/myvd1/にコピーされます。
クラウド サービスの cloudService -
入力エイリアス: EnvironmentName。
string.
ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMsする場合に必要です。
ターゲット クラウド サービスの名前を指定します。
resourceGroup
-
リソース グループの
入力エイリアス: EnvironmentNameRM。
string.
ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMsする場合に必要です。
ターゲット リソース グループの名前を指定します。
によるマシンの選択を ResourceFilteringMethod - する
string. 任意
Destination = AzureVMsするときに使用します。 使用できる値: machineNames (コンピューター名)、tags。 既定値: machineNames.
リソース グループ内の VM のサブセットを識別する VM ホスト名またはタグを指定します。 タグ は、Azure Resource Manager 経由で作成されたリソースでのみサポートされます。
フィルター条件の MachineNames -
string. 任意
Destination = AzureVMsするときに使用します。
ffweb、ffdb、Role:DB、Web、OS:Win8.1などのタグなどの Azure VM ホスト名の一覧を指定します。
注: タグの有効な区切り記号には、,(コンマ)、:(colon)、および ;(semicolon が含まれます。 複数のタグを指定すると、指定したタグを含むすべての VM でタスクが実行されます。 既定では、タスクはすべての VM で実行されます。
vmsAdminUserName
-
管理者ログイン
string.
Destination = AzureVMsする場合に必要です。
Azure VM 管理者アカウントのユーザー名を指定します。
vmsAdminPassword
-
パスワード
string.
Destination = AzureVMsする場合に必要です。
Azure VM 管理者アカウントのパスワードを指定します。
有効な入力には、ビルド パイプラインまたはリリース パイプラインで定義されている変数 ($(passwordVariable)など) が含まれます。 パスワードをセキュリティで保護するには、secretとしてマークします。
宛先フォルダーのを TargetPath - する
string.
Destination = AzureVMsする場合に必要です。
ターゲット VM のローカル パスを指定します。
有効な入力には、$env:windir\BudgetIT\Webなどの環境変数が含まれます。
AdditionalArgumentsForBlobCopy
-
省略可能な引数 (BLOB にファイルをアップロードする場合)
string.
/NC:10などの BLOB にアップロードするときに適用できる AzCopy.exe に追加の引数を指定します。
省略可能な引数が指定されていない場合は、既定で次の引数が追加されます。
/Y/SetContentType/Z/V-
/S- コンテナー名が$rootされていない場合に追加されます。 -
/BlobType:page- 指定したストレージ アカウントが Premium アカウントの場合に追加されます。 -
/Pattern- ソース パスがファイルの場合に追加されます。 その他の指定された省略可能な引数に含まれます。
AdditionalArgumentsForVMCopy
-
オプションの引数 (VM にファイルをダウンロードする場合)
string. 任意
Destination = AzureVMsするときに使用します。
/NC:10などの VM にダウンロードするときに適用できる AzCopy.exe に追加の引数を指定します。
省略可能な引数が指定されていない場合は、既定で次のものが追加されます。
/Y/S/Z/V
コピーの前提条件を有効にする enableCopyPrerequisites -
boolean. 任意
ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMsするときに使用します。 既定値: false.
有効にすると、自己署名証明書を使用して、HTTPS プロトコルではなく、ポート 5986 で Windows リモート管理 (WinRM) リスナーを構成します。 Azure VM でコピー操作を実行するために必要です。 ターゲット VM でロード バランサーを使用する場合は、ターゲット ポート (5986) の受信 NAT 規則を構成します。 ARM VM にのみ適用されます。
並列でのコピーの CopyFilesInParallel -
boolean. 任意
Destination = AzureVMsするときに使用します。 既定値: true.
既定の設定を受け入れると、ターゲット VM に並列でファイルがコピーされます。
クリーン ターゲットの CleanTargetBeforeCopy -
boolean. 任意
Destination = AzureVMsするときに使用します。 既定値: false.
この値を true に設定すると、コピー操作を実行する前に、コピー先フォルダーがクリーンアップされます。
skipCACheck
-
テスト証明書の
boolean. 任意
Destination = AzureVMsするときに使用します。 既定値: true.
既定値では、HTTPS 経由で接続する前に、信頼された CA によってサーバー証明書が署名されたことは検証されません。
ストレージ コンテナー URIの outputStorageUri -
string.
ファイルのコピー先のストレージ コンテナー URI に使用する変数の名前を指定します。 選択した宛先が Azure BLOB の場合にのみ有効です。
ストレージ コンテナー SAS トークンの outputStorageContainerSasToken -
string.
コピーされたファイルにアクセスするストレージ コンテナー SAS トークンに使用される変数の名前を指定します。 選択した宛先が Azure BLOB の場合にのみ有効です。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
バージョン 2.0 の新機能: 新しいバージョンの AzCopy の使用。