啟動自訂 AWS CloudFormation 勾點專案

建立自訂 Hooks 專案的第一步是啟動專案。您可以使用 CloudFormation CLI init命令來啟動自訂 Hooks 專案。

init 命令會啟動精靈，引導您設定專案，包括 Hooks 結構描述檔案。使用此結構描述檔案作為定義勾點形狀和語意的起點。如需詳細資訊，請參閱結構描述語法。

若要啟動 Hook 專案：

1. 建立專案的目錄。

   mkdir ~/mycompany-testing-mytesthook

2. 導覽至新目錄。

   cd ~/mycompany-testing-mytesthook

3. 使用 CloudFormation CLI init命令啟動專案。

   cfn init

   命令會傳回下列輸出：

   Initializing new project

4. init 命令會啟動精靈，引導您設定專案。出現提示時，輸入 h 以指定 Hooks 專案。

   Do you want to develop a new resource(r) a module(m) or a hook(h)?

   h

5. 輸入勾點類型的名稱。

   What's the name of your hook type?
   (Organization::Service::Hook)

   MyCompany::Testing::MyTestHook

6. 如果只安裝一種語言外掛程式，預設會選取該外掛程式。如果已安裝多個語言外掛程式，您可以選擇所需的語言。輸入您選擇的語言的數字選擇。

   Select a language for code generation:
   [1] java
   [2] python38
   [3] python39
   (enter an integer):

7. 根據所選的開發語言設定封裝。

   Python

   (選用) 針對與平台無關的封裝選擇 Docker。雖然 Docker 並非必要，但強烈建議您更輕鬆地進行封裝。

   Use docker for platform-independent packaging (Y/n)?
   This is highly recommended unless you are experienced with cross-platform Python packaging.

   Java

   設定 Java 套件名稱，然後選擇 codegen 模型。您可以使用預設套件名稱，或建立新的套件名稱。

   Enter a package name (empty for default 'com.mycompany.testing.mytesthook'):

   Choose codegen model - 1 (default) or 2 (guided-aws):

結果：您已成功啟動專案，並產生開發勾點所需的檔案。以下是構成 Python 3.8 的 Hooks 專案的目錄和檔案範例。

mycompany-testing-mytesthook.json
rpdk.log
README.md
requirements.txt
hook-role.yaml
template.yml
docs
    README.md
src
    __init__.py
    handlers.py
    models.py
    target_models
        aws_s3_bucket.py

注意

src 目錄中的檔案會根據您的語言選擇建立。產生的檔案中有一些有用的註解和範例。當您執行 generate命令來新增處理常式的執行時間程式碼時models.py，某些檔案，例如 ，會在稍後的步驟中自動更新。