在 AWS DeepRacer 主控台中匯入和匯出模型 - AWS DeepRacer
將您的 AWS DeepRacer 模型複製到 Amazon S3將您的 AWS DeepRacer 模型匯入主控台疑難排解

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

在 AWS DeepRacer 主控台中匯入和匯出模型

在某些情況下，您可能需要匯入或匯出 AWS DeepRacer 模型。參與雇主贊助活動的競賽者可以匯出其模型，以避免失去對他們的存取權，競賽管理員可以提供預先訓練的模型，供出席者在活動期間匯入和使用。使用 您的模型 頁面，在 主控台中匯入和匯出 AWS DeepRacer 模型。

將您的 AWS DeepRacer 模型複製到 Amazon S3

將 AWS DeepRacer 模型複製到 Amazon S3

  1. 登入 AWS DeepRacer 主控台。

  2. 在導覽窗格的強化學習中，選擇您的模型。

  3. 選取模型名稱旁的核取方塊，以選取要匯入的模型。您一次只能從主控台將一個模型複製到 Amazon S3。

  4. 選擇動作按鈕下拉式清單，然後選擇複製到 S3。

    新的複製到 Amazon S3 頁面隨即開啟。

  5. 在複製到 Amazon S3 頁面上，使用 Amazon S3 儲存貯體下拉式清單選擇器選取要匯出模型的 Amazon S3 儲存貯體。AWS DeepRacer S3 儲存貯體的名稱中必須包含 deepacer。

    1. 如果您沒有有效的 Amazon S3 儲存貯體，請選擇建立新儲存貯體來建立一個儲存貯體。下拉式清單會以下列格式填入儲存貯體名稱 aws-deepracer-assets-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。

  6. 將選用的資料夾字首新增至 Amazon S3 S3 物件。

  7. 設定 S3 儲存貯體之後，請選取您要包含的資產。您必須選取至少一個資產類型才能繼續。

    • 模型：模型資料夾包含模型匯入所需的所有必要檔案。

    • 日誌：複製模型的訓練和評估日誌。此選項包含 logs/、 metrics/和 sim-trace/ 資料夾。

    • 影片：此選項會將影片資料夾複製到 Amazon S3 儲存貯體。影片資料夾包含 evaluation/和 training/ 資料夾。這些資料夾包括俯視圖的影片、45 度角視圖和 45 度角視圖，其中主控台浮水印顯示賽道上車輛的位置。

  8. 按複製後，會出現彈出式視窗，通知您負責 Amazon S3 資料儲存成本。若您同意條款，請按快顯視窗上的複製按鈕。

  9. 一旦複製程序開始，您將會回到 主控台中的您的模型頁面。頁面頂端的橫幅會顯示目前狀態。匯出程序完成時，橫幅會確認匯出成功。

模型匯入所需的檔案

若要上傳在主控台以外訓練模型的模型資料夾，請遵循 Amazon S3 文件上傳物件頁面上的步驟。下表包含模型匯入所需的檔案清單。如果缺少任何必要的檔案，模型匯入將會失敗。

在 AWS DeepRacer 主控台中訓練的模型具有資料夾名稱格式 DAY/MONTH/YEAR/TIME GMT。我們的範例模型已於 2023 年 11 月 30 日匯出，資料夾名稱為 Thu, 30 Nov 2023 19:01:24 GMT。在此範例中，我們將此資料夾稱為根資料夾。

模型匯入所需的檔案
檔案名稱 資料夾路徑 Description
.coach_checkpoint 根/模型/ 指導檢查點檔案包含用於匯入之模型檢查點的金鑰。
ckpt 檔案 根/模型/ 檢查點檔案是訓練期間在不同階段取得的模型權重快照。其中包括 ckpt.index、 ckpt.data和 ckpt.meta 檔案。
model_metadata.json 根/ 模型中繼資料檔案包含包含動作空間定義、感應器組態和訓練演算法選擇的設定。
reward_function.py 根/ Python 檔案，其中包含用於訓練模型的獎勵函數。

匯入模型時不需要指標檔案。如果不包含這些檔案，則無法在主控台上使用模型的訓練指標和獎勵圖表。

模型匯入的選用檔案
檔案名稱 資料夾路徑 Description
training_params.yaml 根/ training_params 檔案包含訓練任務資料，其中包含賽道和車輛資訊、競賽者和模型名稱，以及訓練成品的資料夾路徑。
Hyperparameters.json root/ip/ 包含模型的超參數資訊，例如批次大小、損失類型、學習率和 epoch 數量。
training-*.json root/metrics/training/ 用於在 AWS DeepRacer 主控台中視覺化模型的訓練指標。

將您的 AWS DeepRacer 模型匯入主控台

本節會逐步解說將 AWS DeepRacer 模型匯入主控台的程序。您必須先複製模型資料夾的 Amazon S3 URL，才能匯入模型。

複製 AWS DeepRacer Amazon S3 儲存貯體 URL

  1. 登入 Amazon S3 主控台並前往儲存貯體頁面。

  2. 按儲存貯體名稱上的連結，選取您為 AWS DeepRacer 模型建立的 Amazon S3 儲存貯體。在 AWS DeepRacer 主控台中建立的 S3 儲存貯體格式為 aws-deepracer-assets-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。

  3. 從 AWS DeepRacer 儲存貯體的物件索引標籤：

    1. 在名稱欄位中按下模型物件的名稱連結，以選取要匯入的模型。

      隨即顯示子資料夾清單。

    2. 選擇資料夾名稱旁的核取方塊，以選取模型資料夾的根目錄。在 AWS DeepRacer 主控台中訓練的模型具有資料夾名稱格式 DAY/MONTH/YEAR/TIME GMT。

  4. 導覽至模型資料夾的根目錄後，請選取複製 S3 URL 按鈕。複製 s3 URL、複製 URL、開啟和刪除按鈕會顯示為灰色，直到您選取模型名稱旁的核取方塊為止。

    注意

    如果您在複製到 S3 程序期間新增字首，例如 my_model/version_2，則模型資料夾的路徑為 deep_racer_bucket/model_name/my_model/version_2/root/。

將您的模型匯入 AWS DeepRacer 主控台

  1. 在 AWS DeepRacer 主控台上，前往您的模型頁面。

  2. 選取模型容器上的匯入模型按鈕。

    匯入模型頁面隨即出現。

  3. 在匯入區段中：

    1. 輸入您要匯入之模型資料夾的 Amazon S3 URL。Amazon S3 URL 的格式為 s3://deep_racer_bucket/model_name/prefix/root。

  4. 在詳細資訊區段中：

    1. 輸入模型名稱。

    2. 新增模型的選用描述。

    3. 如果您使用的是使用多使用者模式的管理員帳戶，請從下拉式清單選擇您要匯入模型的使用者。

  5. 選取畫面底部的匯入按鈕。

  6. 一旦匯入程序開始，您將會回到 主控台中的您的模型頁面。頁面頂端的橫幅會顯示目前狀態，且模型會以 Importing.. 作為其狀態顯示在模型清單中。匯入程序完成後，橫幅會確認成功匯入，且模型的狀態會從 Importing.. 變更為 Ready。

疑難排解

即使進行多次嘗試，我們仍無法複製您的模型。如果模型仍在 S3 儲存貯體中，請從模型錯誤資料表中選取模型，然後選擇更新，然後選擇匯入，以重試模型匯入。或者，如果您有模型的本機副本，您可以依照 Amazon S3 文件上傳物件頁面上的步驟手動匯入模型。

我們無法複製模型，因為儲存此模型的 S3 儲存貯體已刪除。如果您有模型的副本，請將它放在名稱deepracer為 的 S3 儲存貯體中，然後依照 將您的 AWS DeepRacer 模型匯入主控台區段中的步驟再次嘗試匯入。

存放此模型的 Amazon S3 儲存貯體的許可已變更，因此我們無法複製模型。這可能有兩個原因，您直接編輯了 AWS DeepRacer S3 或 AWS DeepRacer 服務角色政策的許可。如果您直接編輯 AWS DeepRacer S3 儲存貯體的許可，請依照使用下列政策使用 Amazon S3 主控台頁面新增儲存貯體政策中的步驟來還原儲存貯體許可：

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Stmt1586917903457",
            "Effect": "Allow",
            "Principal": {
                "Service": "deepracer.amazonaws.com"
                },
            "Action": [
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
               "arn:aws:s3:::your-bucket-name",
               "arn:aws:s3:::your-bucket-name/*"
            ]
        }
    ]
}

若要在還原儲存貯體許可後匯入模型，請從模型錯誤資料表中選取模型，然後選擇更新。當模型匯入頁面出現時，選擇匯入。

我們無法複製模型，因為它已從 Amazon S3 儲存貯體中刪除。如果您仍然有 檔案，請嘗試將其還原至 AWS DeepRacer 儲存貯體，然後從模型錯誤資料表中選取模型，然後選擇更新。當模型匯入頁面出現時，選擇匯入。如果您有模型的本機副本，您可以依照 Amazon S3 文件上傳物件頁面上的步驟手動匯入檔案。

我們無法複製模型，因為已從 Amazon S3 儲存貯體中刪除指導檢查點中繼資料。如果您仍然有 檔案，請嘗試將其還原至 AWS DeepRacer 儲存貯體，然後從模型錯誤資料表中選取模型，然後選擇更新。出現模型匯入頁面時，選擇匯入。如果您有模型的本機副本，您可以依照 Amazon S3 文件上傳物件頁面上的步驟手動匯入檔案。

我們無法複製模型，因為檢查點檔案已從 Amazon S3 儲存貯體中刪除。如果您仍然有檔案，請嘗試將其還原至 AWS DeepRacer 儲存貯體，然後從模型錯誤資料表中選取模型，然後選擇更新。當模型匯入頁面出現時，選擇匯入。如果您有檔案的本機副本，您可以依照 Amazon S3 文件上傳物件頁面上的步驟手動匯入檔案。

您的模型檔案超過服務可建立的 1 GB 檔案大小限制，因此已編輯您的檔案。此模型將不會匯入。若要移除此訊息，請從模型錯誤資料表中選取模型，然後選擇刪除。

您的檢查點檔案超過服務可建立的 1 GB 檔案大小限制，因此已編輯您的檔案。此模型將不會匯入。若要移除此訊息，請從模型錯誤資料表中選取模型，然後選擇刪除。

您的 YAML 檔案超過服務可以建立的 10 MB 檔案大小限制，因此您的檔案已編輯。此模型將不會匯入。若要移除此訊息，請從模型錯誤資料表中選取模型，然後選擇刪除。

我們無法驗證您的模型，因為它已經過編輯。如果您有模型的副本，請嘗試在 AWS DeepRacer S3 儲存貯體中取代它，然後從模型錯誤資料表中選取模型，然後選擇更新。出現模型匯入頁面時，選擇匯入。

我們無法複製模型，因為在您訓練模型時，AWS DeepRacer 可用的許可已移除。若要授權 AWS DeepRacer 重新建立所需的許可，請從模型錯誤資料表中選擇模型，然後選擇更新。出現模型匯入頁面時，選擇匯入。AWS DeepRacer 會重新建立許可，然後複製模型。