本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
將自訂藍圖發佈到空間
您必須將自訂藍圖發佈到空間的藍圖目錄之前,您必須將其發佈到空間。您也可以在發佈之前在 CodeCatalyst 主控台中檢視藍圖。您可以發佈藍圖的預覽版本或正常版本。
重要
如果您想要使用來自外部來源的藍圖套件,請考慮這些套件可能帶來的風險。您必須負責新增至空間的自訂藍圖及其產生的程式碼。
重要
若要將自訂藍圖發佈到您的 CodeCatalyst 空間,您必須使用在空間中具有 S pace 管理員或 Power 使用者角色的帳戶登入。
檢視和發佈自訂藍圖的預覽版本
如果要將自訂藍圖新增至空間的藍圖目錄,可以將自訂藍圖的預覽版本發佈到您的空間。這可讓您在將非預覽版本新增至目錄之前,以使用者身分檢視藍圖。預覽版可讓您在不佔用實際版本的情況下發佈。例如,如果您使用某個0.0.1
版本,則可以發佈並新增預覽版本,以便可以將第二個版本的新更新發行並新增為0.0.2
。
進行變更後,透過執行檔案來重建自訂藍圖的套package.json
件,並預覽您的變更。
若要檢視和發佈自訂藍圖的預覽版本
-
恢復您的開發環境。如需更多資訊,請參閱恢復開發環境
-
在您的開發環境中打開一個工作終端。
-
(可選)在工作終端中,如果尚未安裝項目,請為項目安裝必要的依賴項。使用下列命令:
yarn
-
(選擇性) 如果您對
.projenrc.ts
檔案進行了變更,請在建置和預覽藍圖之前重新產生專案的組態。使用下列命令:yarn projen
-
使用以下命令重建和預覽您的自訂藍圖。使用下列命令:
yarn blueprint:preview
導覽至提供的
See this blueprint at:
連結以預覽您的自訂藍圖。根據您的組態,檢查 UI (包括文字) 是否如預期般顯示。如果您想要變更自訂藍圖,可以編輯blueprint.ts
檔案、重新同步藍圖,然後再次發佈預覽版本。如需詳細資訊,請參閱 樹脂同步。 -
(選擇性) 您可以發佈自訂藍圖的預覽版本,然後將其新增至空間的藍圖目錄。導覽至
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
命令後,您仍然可以將自訂藍圖發佈到您的空間。
若要檢視和發佈自訂藍圖
-
恢復您的開發環境。如需更多資訊,請參閱恢復開發環境
-
在您的開發環境中打開一個工作終端。
-
-
如果您在建立藍圖時選擇退出版本工作流程產生,請使用下列命令:
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 空間中。如果您有多個企業空間,也可以在這些空間中預覽和發佈相同的藍圖。您也可以將藍圖新增至另一個空間的現有專案。
在指定空間中發佈或新增自訂藍圖
-
恢復您的開發環境。如需詳細資訊,請參閱 恢復開發環境。
-
在您的開發環境中打開一個工作終端。
-
(可選)如果尚未安裝項目,請為項目安裝必要的依賴項。使用下列命令:
yarn
-
使用標
--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
-