使用藍圖工具和 CLI - Amazon CodeCatalyst
使用藍圖工具影像上傳工具

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用藍圖工具和 CLI

藍圖 CLI 提供工具來管理和使用自訂藍圖。

使用藍圖工具

使用藍圖工具

  1. 開啟 CodeCatalyst 主控台，網址為 https：//https://codecatalyst.aws/。

  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. 複製開放原始碼藍圖 GitHub 儲存庫，該儲存庫可存取藍圖 SDK 和範例藍圖。在運作中的終端機中，執行下列命令：

    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 會產生。URL 無法立即使用，因為需要一些時間才能部署 CloudFront 分佈。檢查分佈狀態以取得最新的部署狀態。如需詳細資訊，請參閱使用 分佈。