GCSPut

GCSPut - Google Cloud Storageへファイルをアップロード

Google Cloud Storageへファイルをアップロードします。
Google Cloud Storageへの認証にはサービスアカウントを使用します。サービスアカウントの使用方法は下記トピック「認証に必要な準備」を参照してください。

■ストリーム情報

入力

フォーマット

すべて

接続数

無制限

説明

入力ストリームは使用せず、すべて無視します。

出力

フォーマット

Record

説明

次のようなフィールド定義のレコードが出力されます。

フィールド名	データ型	説明
id	String	アップロードしたオブジェクトのIDを出力します。
size	Integer	アップロードしたオブジェクトのサイズを出力します。

■コンポーネントプロパティ

名前

プロパティ型

マッピング

説明

コネクションを使用

boolean

接続先に以下のコネクション名を使用するかどうか選択します。

はい [true]	-	以下のコネクション名で指定された接続情報を使用します。
いいえ [false]	-	コネクション情報以下のプロパティを使って接続を行います。

コネクション名

connection

コネクションを使用が「はい」の場合に、GCPコネクションを指定します。コネクションペインまたは管理コンソールにて作成されたGCPコネクションを選択します。
各コネクションの詳細については、「はじめに」-「詳細なトピック」-「フローの構成要素」-「コネクションプロパティ」を参照してください。

コネクション情報

group

コネクションを使用プロパティが「いいえ」の場合に使用されるプロパティ群です。

メールアドレス

string

入力＆出力

Google Developer Consoleから取得したサービスアカウントのメールアドレスを設定します。コネクションを使用が「いいえ」の場合にこの設定が参照されます。

証明書のエイリアス

string

入力＆出力

サービスアカウント認証用の証明書のエイリアスを設定します。
コネクションを使用が「いいえ」の場合にこの設定が参照されます。

アプリケーション名

string

入力＆出力

Google Cloud Storageのアプリケーション名を設定します。
Google Cloud Platformのプロジェクト名ではなく、アプリケーションを区別するための名前です。
コネクションを使用が「いいえ」の場合にこの設定が参照されます。

タイムアウト（秒）

int

入力＆出力

リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。
コネクションを使用が「いいえ」の場合にこの設定が参照されます。

プロキシ設定を使用

boolean

管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
プロキシの認証には対応していません。
コネクションを使用が「いいえ」の場合にこの設定が参照されます。

はい [true]	-	プロキシ設定を使用します。
いいえ [false]	-	プロキシ設定を使用しません。

バケット名

string

入力＆出力

オブジェクトをアップロードするバケットの名前を指定します。

オブジェクト名

string

入力＆出力

アップロードするオブジェクトの名前を指定します。
指定しなかった場合はアップロードファイルの名前になります。

アップロードファイルパス

remoteFile

入力＆出力

アップロードするファイルのパスを指定します。

ファイルパスの詳細設定

group

ファイルパスの詳細設定を行うプロパティ群です。

相対パスの起点

pathResolver

相対パス指定の場合にベースフォルダーを指定します。

プロジェクトフォルダー [Relative]: プロジェクトファイルと同じフォルダーを起点にします。
ホームフォルダー [ProjectOwner]: ユーザーのホームフォルダーを起点にします。
実行ユーザーのホームフォルダー [ExecuteUser]: 実行ユーザーのホームフォルダーを起点にします。

絶対パスを許可

boolean

絶対パスを許可するかどうか選択します。

「..」を許可

boolean

上のフォルダへ移動する記述に「..」を許可するかどうか選択します。

ContentType

string

入力＆出力

コンテントタイプを指定します。指定しない場合は自動で設定されます。

上書きを許可

boolean

入力＆出力

オブジェクトを上書きするかどうか選択します。

はい [true]	-	オブジェクトを上書きします。
いいえ [false]	-	オブジェクトが存在するのエラーを発生します。

ロールバック時の処理

choice

ロールバック時にアップロードしたオブジェクトを削除するかどうかを選択します。

オブジェクトを削除 [true]	-	削除します。
何もしない [false]	-	何もしません。

メタデータ

■トランザクション処理

コミット	何もしません。
ロールバック	ロールバック時の処理が「オブジェクトを削除」の場合、オブジェクトを削除します。

■エラー処理

タイプ	パラメーター	エラー処理フローへのストリーム	エラーコード	説明
汎用	なし	コンポーネントの入力ストリーム	1	ローカルファイルパスが不正だった場合
			2	通信に失敗した場合
			3	アクセスに失敗した場合
			4	証明書の認証に失敗した場合
			5	プロパティが不正だった場合
			7	出力ストリームのフィールドのデータ型の定義が不正だった場合
オブジェクトが存在する	なし	コンポーネントの入力ストリーム	8	オブジェクトが既に存在する場合

■認証に必要な準備

Google Cloud Storage系コンポーネントを使用するには、Google Cloud（GCP）でサービスアカウントとその鍵を作成し、鍵に含まれる秘密鍵を管理コンソールでユーザーの証明書としてインポートする必要があります。

フローサービスにインポートできる鍵の形式はPKCS#12（P12）またはJava KeyStoreです。Google CloudコンソールのサービスアカウントのキーではJSON形式の鍵しか作成できないため、次の「方法A」または「方法B」でPKCS#12形式の鍵を用意します。

1. サービスアカウントを作成する

Google Cloudコンソールで「IAMと管理」-「サービスアカウント」を開き、サービスアカウントを作成します。
作成したサービスアカウントに、対象のバケットにアクセスできる権限（「Storage 管理者」または「Storage オブジェクト管理者」など）を付与します。
「APIとサービス」で「Cloud Storage JSON API」を有効にします。
サービスアカウントのメールアドレス（[サービスアカウント名]@[プロジェクトID].iam.gserviceaccount.com）を控えておきます。コネクションの「メールアドレス」に指定します。

2. PKCS#12形式の鍵を用意する

方法A：gcloud CLIでPKCS#12形式の鍵を作成する

Google Cloud CLI（gcloud）が使用できる場合は、PKCS#12形式の鍵を直接作成できます。

gcloud iam service-accounts keys create key.p12 --iam-account=[サービスアカウントのメールアドレス] --key-file-type=p12

作成されたファイルのパスワードは「notasecret」です。

方法B：JSON形式の鍵をPKCS#12形式に変換する

gcloud CLIが使用できない場合は、Google CloudコンソールでJSON形式の鍵をダウンロードし、OpenSSLでPKCS#12形式に変換します。

「IAMと管理」-「サービスアカウント」でサービスアカウントを選択し、「キー」タブの「鍵を追加」-「新しい鍵を作成」で「JSON」を選択してダウンロードします。
ダウンロードしたJSONファイルのprivate_keyの値（-----BEGIN PRIVATE KEY-----から-----END PRIVATE KEY-----まで）を取り出し、privatekey.pemとして保存します。JSON中の\nは改行に置き換えます。
Windows PowerShellでは次のコマンドで取り出せます。
```
(Get-Content key.json -Raw | ConvertFrom-Json).private_key | Set-Content privatekey.pem -NoNewline -Encoding ascii
```
秘密鍵から自己署名証明書を作成し、秘密鍵とあわせてPKCS#12形式のファイルにします。
```
openssl req -new -x509 -key privatekey.pem -out cert.pem -days 3650 -subj "/CN=[サービスアカウントのメールアドレス]"
openssl pkcs12 -export -inkey privatekey.pem -in cert.pem -name privatekey -out key.p12 -passout pass:[任意のパスワード]
```
証明書はフローサービスが秘密鍵を格納するために必要なもので、認証には使用されません。-subjや-daysの値は任意です。

秘密鍵はサービスアカウントの認証情報そのものです。取り扱いには注意し、不要になったJSONファイルや中間ファイルは削除してください。

3. 管理コンソールで証明書をインポートする

管理コンソールの「ツール」-「アカウント」画面でフローの実行ユーザーを選択し、「ユーザーの証明書設定・情報」の「証明書」で「証明書のインポート」を実行します。
「インポートするファイル」に手順2で用意したPKCS#12ファイルを指定し、「ファイルのパスワード」にそのファイルのパスワード（方法Aの場合は「notasecret」）を入力します。
「格納エイリアス名」に任意のエイリアス名を入力します。コネクションの「証明書のエイリアス」に指定します。
「格納用パスワード」と「格納用秘密鍵パスワード」に、フローサービスで証明書を格納するための任意のパスワード（6文字以上）を入力します。

4. コネクションを設定する

「メールアドレス」に手順1で控えたサービスアカウントのメールアドレスを入力します。
「証明書のエイリアス」に手順3で指定した格納エイリアス名を入力します。

注意

組織のポリシー（iam.disableServiceAccountKeyCreation）によってサービスアカウントの鍵の作成が禁止されている場合は、鍵を作成できません。組織の管理者に確認してください。

■動作に必要な設定

Google Cloud Storage系コンポーネントを使用するには、外部ライブラリが必要となります。

以下のjarファイルをダウンロードして、[DATA_DIR]/system/lib/userlibフォルダーにコピーしてください。
フローサービスを再起動してください。

■バケットとオブジェクトの設定画面

コンポーネントをダブルクリックするか、右クリックメニューの「Google Cloud Storage Browser」を実行することで、コンポーネントに設定されている接続情報を使用して設定画面が開きます。
この画面ではバケット名とオブジェクト名の設定とバケットの新規作成、そしてバケットとオブジェクトの削除を行うことができます。
まず最初に「プロジェクト」にプロジェクトIDかプロジェクトのナンバーを入力してから「バケットリスト」ボタンをクリックしてください。

「バケット」ツリーリスト

バケットとオブジェクトのツリーリストが表示されます。
このリストの中からコンポーネント設定するバケットとオブジェクトを選択します。

「プロジェクト」

バケットのプロジェクトを指定します。
プロジェクトのIDかナンバーを指定してください。プロジェクト名には対応していません。
コンポーネントのバケット名が指定されている場合、そのバケットが所属するプロジェクトのナンバーが表示されます。

「バケットリスト」ボタン

指定したプロジェクトのバケットリストを表示します。

バケット名

選択したバケットの値が表示されます。

オブジェクト名

選択したオブジェクトの値が表示されます。

「バケットを作成」ボタン

バケットを作成するためのダイアログが表示されます。

「バケットを削除」ボタン

「バケット」ツリーリストで選択されているバケットをサーバーから削除します。

「オブジェクトを削除」ボタン

「バケット」ツリーリストで選択されているオブジェクトをサーバーから削除します。

属性情報

選択されているバケットまたはオブジェクトの属性情報が表示されます。
ファイル内容はUTF-8で表示します。それ以外のエンコーディングではうまく表示できない場合があります。

「OK」ボタン

リストで選択されたバケットとオブジェクトの情報をコンポーネントのバケット名とオブジェクト名プロパティに設定します。

「キャンセル」ボタン

このダイアログを閉じます。
コンポーネントのバケット名とオブジェクト名プロパティに変更はありません。