asset computeプロジェクト

asset computeプロジェクトは、Adobe I/OCLIを使用して生成されるNode.jsプロジェクトで、Adobe I/O RuntimeにデプロイしてAEM as aCloud Serviceと統合できる特定の構造に準拠します。 1つのAsset computeプロジェクトに1つ以上のAsset computeワーカーを含め、それぞれがAEMからCloud Service処理プロファイルとして参照可能な個別のHTTPエンドポイントを持つことができます。

プロジェクトの生成

asset computeプロジェクトの生成のクリックスルー(オーディオなし)

Adobe I/OCLIAsset computeプラグインを使用して、新しい空のAsset computeプロジェクトを生成します。

  1. コマンドラインから、プロジェクトを含むフォルダに移動します。
  2. コマンドラインからaio app initを実行し、インタラクティブなプロジェクト生成CLIを開始します。
    • このコマンドは、認証を求めるWebブラウザを起動する場合があります。Adobe I/Oその場合は、必要なAdobe サービスと製品に関連付けられたAdobe資格情報を提供します。 ログインできない場合は、以下の手順に従って、プロジェクト🔗を生成します。
  3. 組織を選択
    • AEMをAdobeとして持つCloud Service組織を選択します。Project Fireflyは次の場所に登録されています。
  4. プロジェクトを選択
    • プロジェクトを探して選択します。 これは、Fireflyプロジェクトテンプレート(この場合はWKND AEM Asset Compute)から作成されたプロジェクトタイトルです。
  5. ワークスペースの選択
    • Developmentワークスペースを選択します。
  6. このプロジェクトに対して有効にするAdobe I/Oアプリ機能を選択してください。含めるコンポーネントを選択
    • Actions: Deploy runtime actions
    • 矢印キーを使用して選択および選択解除するにはスペースを選択し、選択を確定するにはEnterキーを使用します。
  7. 生成するアクションのタイプの選択
    • Adobe Asset Compute Worker
    • 矢印キーを使用して選択し、選択を解除または選択する間隔、選択を確定するにはEnterキーを使用します。
  8. このアクションの名前を指定してください。
    • デフォルトの名前workerを使用します。
    • 異なるアセット計算を実行する複数のワーカーがプロジェクトに含まれている場合は、意味的に名前を付けます

console.jsonを生成します

開発者ツールには、Adobe I/Oに接続するために必要な資格情報を含む、console.jsonという名前のファイルが必要です。このファイルは、Adobe I/Oコンソールからダウンロードします。

  1. asset computeワーカーのAdobe I/Oプロジェクトを開きます。
  2. console.json資格情報をダウンロードするプロジェクトワークスペースを選択します。この場合はDevelopmentを選択します。
  3. Adobe I/Oプロジェクトのルートに移動し、右上隅の「すべて​をダウンロード」をタップします。
  4. ファイルは、次のように、プロジェクトとワークスペースのプレフィックスが付いた.jsonファイルとしてダウンロードされます。wkndAemAssetCompute-81368-Development.json
  5. 次のいずれかの操作を実行できます。
    • ファイルの名前をconfig.jsonに変更し、Asset computeワーカープロジェクトのルートに移動します。 これは、このチュートリアルのアプローチです。

    • 任意のフォルダーに移動し、設定エントリASSET_COMPUTE_INTEGRATION_FILE_PATHを使用して.envファイルからそのフォルダーを参照します。 ファイルパスは、絶対パスまたはプロジェクトのルートを基準とした相対パスにすることができます。 次に例を示します。

      • ASSET_COMPUTE_INTEGRATION_FILE_PATH=/Users/example-user/secrets/wkndAemAssetCompute-81368-Development.json

      または

      • ASSET_COMPUTE_INTEGRATION_FILE_PATH=../../secrets/wkndAemAssetCompute-81368-Development.json.json

注意
ファイルには資格情報が含まれています。プロジェクト内にファイルを保存する場合は、共有されないように、.gitignoreファイルにファイルを追加してください。 .envファイルにも同じことが当てはまります。これらの資格情報ファイルを共有したり、Gitに保存したりすることはできません。

プロジェクトの詳細な構造を確認する

生成されるAsset computeプロジェクトは、Project Firefly専用のAdobeプロジェクトとして使用されるNode.jsプロジェクトです。 次の構造要素は、プロジェクトに固有のAsset computeです。

  • /actions にはサブフォルダーが含まれ、各サブフォルダーにはAsset computeワーカーが定義されます。
    • /actions/<worker-name>/index.js は、このワーカーの作業を実行するために使用するJavaScriptを定義します。
      • フォルダー名workerはデフォルトで、manifest.ymlに登録されている限り、任意の名前を指定できます。
      • 必要に応じて/actionsの下に複数のワーカーフォルダーを定義できますが、manifest.ymlに登録する必要があります。
  • /test/asset-compute には、各ワーカーのテストスイートが含まれます。/actionsフォルダーと同様に、/test/asset-computeには複数のサブフォルダーを含めることができ、それぞれがテストするワーカーに対応します。
    • /test/asset-compute/workerは、特定のワーカーのテストスイートを表し、特定のテストケースを表すサブフォルダーと、テスト入力、パラメーター、予想される出力が含まれます。
  • /build には、テストケース実行時の出力、ログおよびAsset computeのアーティファクトが含まれます。
  • /manifest.yml プロジェクトが提供するAsset computeワーカーを定義します。各ワーカー実装をAEMでCloud Serviceとして使用できるようにするには、このファイルにワーカー実装を列挙する必要があります。
  • /console.json Adobe I/O設定の定義
    • このファイルは、aio app useコマンドを使用して生成/更新できます。
  • /.aio aio CLIツールで使用される設定が含まれます。
    • このファイルは、aio app useコマンドを使用して生成/更新できます。
  • /.env は構文で環境変数を定義 key=value し、共有しないシークレットを含みます。これらのシークレットを保護するために、このファイルはGitにチェックインしないでください。また、プロジェクトのデフォルトの.gitignoreファイルでは無視されます。
    • このファイルは、aio app useコマンドを使用して生成/更新できます。
    • このファイルで定義された変数は、コマンドラインで変数を書き出すことで上書きできます。

プロジェクト構造のレビューの詳細については、「AdobeProject Fireflyプロジェクトの分析」を参照してください。

開発の大部分は、ワーカー実装を開発する/actionsフォルダーと、カスタムAsset computeワーカーのテストを記述する/test/asset-computeフォルダーで行われます。

asset computeプロジェクト(GitHub)

最終的なAsset computeプロジェクトは、GitHubで次の場所から入手できます。

GitHubには、プロジェクトの最終状態が含まれ、ワーカーとテストケースが完全に入力されますが、資格情報( .env、または)は含まれ console.json ません .aio

このページ