本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
將環境元件新增至藍圖
自訂藍圖精靈是從透過精靈公開的Options
介面動態產生的。藍圖支援從公開類型產生使用者介面 (UI) 元件。
若要匯入 Amazon CodeCatalyst 藍圖環境元件
在您的blueprint.ts
檔案中,新增下列內容:
import {...} from '@amazon-codecatalyst/codecatalyst-environments'
建立開發環境
下列範例顯示如何將應用程式部署到雲端:
export interface Options extends ParentOptions { ... myNewEnvironment: EnvironmentDefinition{ thisIsMyFirstAccountConnection: AccountConnection{ thisIsARole: Role['lambda', 's3', 'dynamo']; }; }; }
介面會產生 UI 元件,要求使用單一帳戶連線 (thisIsMyFirstAccountConnection
. myNewEnvironment
帳號連線上的角色 (thisIsARole
) 也會以最低必要的['lambda', 's3', 'dynamo']
角色權能產生。並非所有使用者都有帳戶連線,因此您應該檢查使用者未連線帳戶或未與角色連線帳戶的情況。角色也可以用@inlinePolicies
註釋。如需詳細資訊,請參閱 @inlinePolicy. /路徑/到/政策/文件/json。
環境元件需要name
和environmentType
。下面的代碼是所需的最小默認形狀:
{ ... "myNewEnvironment": { "name": "myProductionEnvironment", "environmentType": "PRODUCTION" }, }
然後 UI 組件會提示您輸入各種欄位。當您填寫欄位時,藍圖會取得完全展開的形狀。為了測試和開發目的,在defaults.json
文件中包含完整的模擬可能會有所幫助。
模擬界面示例
簡單的模擬界面
{ ... "thisIsMyEnvironment": { "name": "myProductionEnvironment", "environmentType": "PRODUCTION", "thisIsMySecondAccountConnection": { "id": "12345678910", "name": "my-account-connection-name", "secondAdminRole": { "arn": "arn:aws:iam::12345678910:role/ConnectedQuokkaRole", "name": "ConnectedQuokkaRole", "capabilities": [ "lambda", "s3", "dynamo" ] } } } }
複雜的模擬界面
export interface Options extends ParentOptions { /** * The name of an environment * @displayName This is a Environment Name * @collapsed */ thisIsMyEnvironment: EnvironmentDefinition{ /** * comments about the account that is being deployed into * @displayName This account connection has an overriden name * @collapsed */ thisIsMyFirstAccountConnection: AccountConnection{ /** * Blah blah some information about the role that I expect * e.g. here's a copy-pastable policy: [to a link] * @displayName This role has an overriden name */ adminRole: Role['admin', 'lambda', 's3', 'cloudfront']; /** * Blah blah some information about the second role that I expect * e.g. here's a copy-pastable policy: [to a link] */ lambdaRole: Role['lambda', 's3']; }; /** * comments about the account that is being deployed into */ thisIsMySecondAccountConnection: AccountConnection{ /** * Blah blah some information about the role that I expect * e.g. here's a copy-pastable policy: [to a link] */ secondAdminRole: Role['admin', 'lambda', 's3', 'cloudfront']; /** * Blah blah some information about the second role that I expect * e.g. here's a copy-pastable policy: [to a link] */ secondLambdaRole: Role['lambda', 's3']; }; }; }
完整的模擬界面
{ ... "thisIsMyEnvironment": { "name": "my-production-environment", "environmentType": "PRODUCTION", "thisIsMySecondAccountConnection": { "id": "12345678910", "name": "my-connected-account", "secondAdminRole": { "name": "LambdaQuokkaRole", "arn": "arn:aws:iam::12345678910:role/LambdaQuokkaRole", "capabilities": [ "admin", "lambda", "s3", "cloudfront" ] }, "secondLambdaRole": { "name": "LambdaQuokkaRole", "arn": "arn:aws:iam::12345678910:role/LambdaQuokkaRole", "capabilities": [ "lambda", "s3" ] } }, "thisIsMyFirstAccountConnection": { "id": "12345678910", "name": "my-connected-account", "adminRole": { "name": "LambdaQuokkaRole", "arn": "arn:aws:iam::12345678910:role/LambdaQuokkaRole", "capabilities": [ "admin", "lambda", "s3", "cloudfront" ] }, "lambdaRole": { "name": "LambdaQuokkaRole", "arn": "arn:aws:iam::12345678910:role/LambdaQuokkaRole", "capabilities": [ "lambda", "s3" ] } } }, }