ブループリントツールと CLI の使用 - Amazon CodeCatalyst
ブループリントツールの使用イメージのアップロードツール

Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「CodeCatalyst から移行する方法」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ブループリントツールと CLI の使用

[ブループリント CLI] は、カスタムブループリントを管理および操作するためのツールを提供します。

ブループリントツールの使用

ブループリントツールを操作するには

  1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

  2. 開発環境を再開します。詳細については、「開発環境の再開」を参照してください。

    開発環境がない場合は、まず開発環境を作成する必要があります。詳細については、「開発環境の作成」を参照してください。

  3. 作業中のターミナルで、次のコマンドを実行してブループリント CLI をインストールします。

    npm install -g @amazon-codecatalyst/blueprint-util.cli

  4. blueprint.ts ファイルで、使用するツールを次の形式でインポートします。

    import { <tooling-function-name> } from '@amazon-codecatalyst/blueprint-util.cli/lib/<tooling-folder-name>/<tooling-file-name>;
    ヒント

    CodeCatalyst blueprints GitHub repository にアクセスして、使用するツールの名前を検索できます。

    イメージアップロードツールを使用する場合は、スクリプトに以下を追加します。

    import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';

    例

    • 公開関数を使用する場合は、スクリプトに以下を追加します。

      import { publish } from '@amazon-codecatalyst/blueprint-util.cli/lib/publish/publish';

    • イメージアップロードツールを使用する場合は、スクリプトに以下を追加します。

      import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';

  5. 関数を呼び出します

    例:

    • 公開関数を使用する場合は、スクリプトに以下を追加します。

      await publish(logger, config.publishEndpoint, {<your publishing options>});

    • イメージアップロードツールを使用する場合は、スクリプトに以下を追加します。

      const {imageUrl, imageName} = await uploadImagePublicly(logger, 'path/to/image'));

イメージのアップロードツール

イメージアップロードツールを使用すると、AWS アカウントの S3 バケットに独自のイメージをアップロードし、そのイメージを CloudFront の背後に公開できます。このツールは、ローカルストレージ (およびオプションのバケット名) 内のイメージパスを入力として受け取り、公開されているイメージに URL を返します。詳細については、「Amazon CloudFront とは」および「Amazon S3 とは」を参照してください。

イメージアップロードツールを使用するには

  1. ブループリント SDK とサンプルブループリントにアクセスできるようになるオープンソースブループリント GitHub リポジトリをクローンします。ターミナルウィンドウで、以下のコマンドを実行します。

    git clone https://github.com/aws/codecatalyst-blueprints.git

  2. 次のコマンドを実行して、ブループリント GitHub リポジトリに移動します。

    cd codecatalyst-blueprints

  3. 次のコマンドを実行して、従属関係をインストールします。

    yarn && yarn build

  4. 次のコマンドを実行して、最新のブループリント CLI バージョンがインストールされていることを確認します。

    yarn upgrade @amazon-codecatalyst/blueprint-util.cli

  5. イメージをアップロードする S3 バケットを使用して AWS アカウントにログインします。詳細については、「AWS CLI を構成する」、「AWS コマンドラインインターフェイスにサインインする」を参照してください。

  6. CodeCatalyst リポジトリのルートから次のコマンドを実行して、ブループリント CLI を使用してディレクトリに移動します。

    cd packages/utils/blueprint-cli

  7. 次のコマンドを実行して、S3 バケットにパッケージをアップロードします。

    yarn blueprint upload-image-public <./path/to/your/image> 
      <optional:optional-bucket-name>

イメージの URL が生成されます。CloudFront ディストリビューションをデプロイするには時間がかかるため、URL はすぐには利用できません。ディストリビューションステータスを確認して、最新のデプロイステータスを取得します。詳細については、「ディストリビューションの使用」を参照してください。