將自訂藍圖發佈到空間 - Amazon CodeCatalyst

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

將自訂藍圖發佈到空間

您必須將自訂藍圖發佈到空間的藍圖目錄之前,您必須將其發佈到空間。您也可以在發佈之前在 CodeCatalyst 主控台中檢視藍圖。您可以發佈藍圖的預覽版本或正常版本。

重要

如果您想要使用來自外部來源的藍圖套件,請考慮這些套件可能帶來的風險。您必須負責新增至空間的自訂藍圖及其產生的程式碼。

重要

若要將自訂藍圖發佈到您的 CodeCatalyst 空間,您必須使用在空間中具有 S pace 管理員Power 使用者角色的帳戶登入。

檢視和發佈自訂藍圖的預覽版本

如果要將自訂藍圖新增至空間的藍圖目錄,可以將自訂藍圖的預覽版本發佈到您的空間。這可讓您在將非預覽版本新增至目錄之前,以使用者身分檢視藍圖。預覽版可讓您在不佔用實際版本的情況下發佈。例如,如果您使用某個0.0.1版本,則可以發佈並新增預覽版本,以便可以將第二個版本的新更新發行並新增為0.0.2

進行變更後,透過執行檔案來重建自訂藍圖的套package.json件,並預覽您的變更。

若要檢視和發佈自訂藍圖的預覽版本

  1. 恢復您的開發環境。如需更多資訊,請參閱恢復開發環境

  2. 在您的開發環境中打開一個工作終端。

  3. (可選)在工作終端中,如果尚未安裝項目,請為項目安裝必要的依賴項。使用下列命令:

    yarn
  4. (選擇性) 如果您對.projenrc.ts檔案進行了變更,請在建置和預覽藍圖之前重新產生專案的組態。使用下列命令:

    yarn projen
  5. 使用以下命令重建和預覽您的自訂藍圖。使用下列命令:

    yarn blueprint:preview

    導覽至提供的See this blueprint at:連結以預覽您的自訂藍圖。根據您的組態,檢查 UI (包括文字) 是否如預期般顯示。如果您想要變更自訂藍圖,可以編輯blueprint.ts檔案、重新同步藍圖,然後再次發佈預覽版本。如需詳細資訊,請參閱 樹脂同步

  6. (選擇性) 您可以發佈自訂藍圖的預覽版本,然後將其新增至空間的藍圖目錄。導覽至Enable version [preview version number] at:連結以將預覽版本發佈至您的空間。

您可以模擬專案建立,而不必在中 CodeCatalyst建立專案。要合成您的項目,請使用以下命令:

yarn blueprint:synth

藍圖會在synth/synth.[options-name]/proposed-bundle/資料夾中產生。如需詳細資訊,請參閱 合成

如果您要更新自訂藍圖,請改為使用下列命令重新同步專案:

yarn blueprint:resynth

藍圖會在synth/synth.[options-name]/proposed-bundle/資料夾中產生。如需詳細資訊,請參閱 樹脂同步

發佈預覽版本後,您可以新增藍圖,以便空間成員可以使用它來建立新專案或在現有專案中新增。如需詳細資訊,請參閱 將自訂藍圖新增至空間藍圖目錄

檢視和發佈自訂藍圖的一般版本

完成開發和預覽自訂藍圖之後,您可以檢視並發佈要新增至空間藍圖目錄的新版本。建立專案時產生的發行工作流程會自動發佈已推送的變更。如果您在建立藍圖時關閉工作流程產生,則您的藍圖不會自動新增至空間的藍圖目錄。執行yarn命令後,您仍然可以將自訂藍圖發佈到您的空間。

若要檢視和發佈自訂藍圖

  1. 恢復您的開發環境。如需更多資訊,請參閱恢復開發環境

  2. 在您的開發環境中打開一個工作終端。

    • 如果您在建立藍圖時選擇退出版本工作流程產生,請使用下列命令:

      yarn blueprint:release

      您仍然可以導覽至提供的See this blueprint at:連結以檢視自訂藍圖。

      發佈自訂藍圖的更新版本,然後可將其新增至空間的藍圖目錄。導覽至Enable version [release version number] at:連結,將最新版本發佈至您的空間。

    • 如果您在建立藍圖時選擇加入發行工作流程,則推送變更時會自動發佈最新的藍圖版本。使用下列命令:

      git add .
      git commit -m "commit message"
      git push

發佈正常版本後,您可以新增藍圖,以便空間成員可以使用它來建立新專案或在現有專案中新增。如需詳細資訊,請參閱 將自訂藍圖新增至空間藍圖目錄

在指定的空間和專案中發佈和新增自訂藍圖

依預設,blueprint:preview和命blueprint:release令會發佈到您在其中建立藍圖的 CodeCatalyst 空間中。如果您有多個企業空間,也可以在這些空間中預覽和發佈相同的藍圖。您也可以將藍圖新增至另一個空間的現有專案。

在指定空間中發佈或新增自訂藍圖

  1. 恢復您的開發環境。如需詳細資訊,請參閱 恢復開發環境

  2. 在您的開發環境中打開一個工作終端。

  3. (可選)如果尚未安裝項目,請為項目安裝必要的依賴項。使用下列命令:

    yarn
  4. 使用標--space籤將預覽或一般版本發佈到指定的空間。例如:

    • yarn blueprint:preview --space my-awesome-space # publishes under a "preview" version tag to 'my-awesome-space'

      輸出範例:

      Enable version 0.0.1-preview.0 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.0/projects/create
    • yarn blueprint:release --space my-awesome-space # publishes normal version to 'my-awesome-space'

      輸出範例:

      Enable version 0.0.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1/projects/create

    使用--project將自訂藍圖的預覽版本新增至指定空間中的現有專案。例如:

    yarn blueprint:preview --space my-awesome-space --project my-project # previews blueprint application to an existing project

    輸出範例:

    Enable version 0.0.1-preview.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints Blueprint applied to [my-project]: https://codecatalyst.aws/spaces/my-awesome-space/projects/my-project/blueprints/%40amazon-codecatalyst%2FmySpace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.1/add