[ブループリント CLI]
ブループリントツールの使用
ブループリントツールを操作するには
https://codecatalyst.aws/
で CodeCatalyst コンソールを開きます。 -
開発環境を再開します。詳細については、「開発環境の再開」を参照してください。
開発環境がない場合は、まず開発環境を作成する必要があります。詳細については、「開発環境の作成」を参照してください。
-
作業中のターミナルで、次のコマンドを実行してブループリント CLI をインストールします。
npm install -g @amazon-codecatalyst/blueprint-util.cli
-
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';
-
-
関数を呼び出します
例:
-
公開関数を使用する場合は、スクリプトに以下を追加します。
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 とは」を参照してください。
イメージアップロードツールを使用するには
-
ブループリント SDK とサンプルブループリントにアクセスできるようになるオープンソースブループリント GitHub リポジトリ
をクローンします。ターミナルウィンドウで、以下のコマンドを実行します。 git clone https://github.com/aws/codecatalyst-blueprints.git
-
次のコマンドを実行して、ブループリント GitHub リポジトリに移動します。
cd codecatalyst-blueprints
-
次のコマンドを実行して、従属関係をインストールします。
yarn && yarn build
-
次のコマンドを実行して、最新のブループリント CLI バージョンがインストールされていることを確認します。
yarn upgrade @amazon-codecatalyst/blueprint-util.cli
-
イメージをアップロードする S3 バケットを使用して AWS アカウントにログインします。詳細については、「AWS CLI を構成する」、「AWS コマンドラインインターフェイスにサインインする」を参照してください。
-
CodeCatalyst リポジトリのルートから次のコマンドを実行して、ブループリント CLI を使用して ディレクトリに移動します。
cd packages/utils/blueprint-cli
-
次のコマンドを実行して、S3 バケットにパッケージをアップロードします。
yarn blueprint upload-image-public
<./path/to/your/image>
<optional:optional-bucket-name>
イメージの URL が生成されます。CloudFront ディストリビューションをデプロイするには時間がかかるため、URL はすぐには利用できません。ディストリビューションステータスを確認して、最新のデプロイステータスを取得します。詳細については、「ディストリビューションの使用」を参照してください。