本文介紹如何在個人版實例創建鏡像倉庫、設置構建規則以及構建鏡像。
使用說明
個人版鏡像構建的超時時間設定為30分鐘。如果您對構建性能有要求,需要使用靈活構建配置、自定義構建參數、多架構構建等功能,建議您使用企業版實例構建鏡像。具體操作,請參見使用企業版實例構建鏡像。
使用個人版實例構建鏡像前,您需要確保Dockerfile文件中的基礎鏡像滿足以下要求:
支持使用所有免授權的公開公網鏡像。
支持使用個人版同地域同賬號的私有公網鏡像。
不支持使用個人版非同地域私有鏡像。
不支持使用所有地域VPC網絡鏡像。
不支持使用第三方授權鏡像。
例如,在構建鏡像時,您的Dockerfile文件中的基礎鏡像可以使用個人版的公網公開鏡像,不可以使用第三方授權鏡像。
功能特點
使用構建功能需綁定源代碼倉庫,請您創建個人版實例后,綁定源代碼倉庫。
代碼變更時自動觸發構建
開啟代碼變更自動構建鏡像后,每次提交代碼將自動觸發鏡像構建,減少手動觸發構建的繁瑣工作。
登錄容器鏡像服務控制臺。
在頂部菜單欄,選擇所需地域。
在左側導航欄,選擇實例列表。
在實例列表頁面單擊個人版實例。
在個人版實例管理頁面選擇
。在鏡像倉庫頁面,單擊目標倉庫右側操作列的管理。
在左側導航欄,選擇構建,然后開啟代碼變更自動構建鏡像。
海外構建
代碼構建過程中可能會依賴國外源,但由于網絡環境,ACR提供海外機器構建功能。在海外構建完成后,將鏡像推送到指定地域的倉庫中。
說明有時海外回中國內地的網絡不穩定,可能會導致鏡像推送超時失敗。
不使用緩存
開啟不使用緩存后,每次構建都會重新拉取基礎依賴鏡像,這可能會增加鏡像拉取時間,因此建議關閉該選項。
多階段構建
阿里云容器鏡像構建同時支持多階段構建特性。更多信息,請參見多階段構建。
步驟一:綁定代碼源
綁定代碼源,本文以綁定GitHub為例。
本地倉庫不支持鏡像構建功能。
接入VPC內的私有GitLab,請參見使用VPC安全構建模式構建容器鏡像。
登錄容器鏡像服務控制臺。
在頂部菜單欄,選擇所需地域。
在左側導航欄,選擇實例列表。
在實例列表頁面單擊個人版實例。
在個人版實例管理頁面選擇
。在代碼源頁面單擊GitHub右側操作列下的綁定賬號。
在GitHub對話框單擊點擊前往源代碼倉庫登錄。
在GitHub頁面輸入賬號和密碼,然后單擊Sign in。
頁面自動跳轉至容器鏡像控制臺,并且顯示您已成功綁定GitHub賬號。
步驟二:創建鏡像倉庫
創建鏡像倉庫前,需要在所需地域下已創建命名空間。更多信息,請參見命名空間的基本操作。
登錄容器鏡像服務控制臺。
在頂部菜單欄,選擇所需地域。
在左側導航欄,選擇實例列表。
在實例列表頁面單擊個人版實例。
在個人版實例管理頁面選擇
。在鏡像倉庫頁面單擊創建鏡像倉庫。
在倉庫信息配置向導中,設置命名空間、倉庫名稱、摘要和倉庫類型,本例選擇私有鏡像倉庫類型。然后單擊下一步。
在代碼源配置向導中設置代碼源、構建設置、構建規則設置,單擊創建鏡像倉庫。
參數
說明
代碼源
選擇代碼源,本文以選擇GitHub代碼為例。單擊GitHub,然后選擇命名空間和倉庫。
構建設置
代碼變更時自動構建鏡像:當分支有代碼提交后會自動觸發構建規則。
海外機器構建:構建時會在海外機房構建,構建成功后推送到指定地域。如果您構建任務涉及的源代碼倉庫、容器鏡像倉庫等資源在中國內地,建議您關閉海外機器構建,使用中國內地構建。
不使用緩存:每次構建鏡像時會強制重新拉取基礎依賴鏡像,可能會增加構建時間。關閉不使用緩存,可以加速鏡像的構建時間。
步驟三:設置構建規則
如果您的鏡像倉庫管理頁面沒有構建,說明綁定源代碼失敗,請參見步驟一重新綁定源代碼。
登錄容器鏡像服務控制臺。
在頂部菜單欄,選擇所需地域。
在左側導航欄,選擇實例列表。
在實例列表頁面單擊個人版實例。
在個人版實例管理頁面選擇
。在鏡像倉庫頁面單擊目標倉庫右側操作列中的管理。
在鏡像倉庫管理頁面左側導航欄單擊構建,在構建規則設置區域的左側單擊添加規則。
說明如需修改構建規則,單擊目標規則操作列中的修改。
在添加構建規則對話框中設置構建規則,然后單擊確定。
參數
說明
類型
設置源代碼倉庫的類型,可以是Branch或Tag。
Branch/Tag
設置構建的代碼分支。
構建上下文目錄
設置Dockerfile文件所在的目錄。指的是相對目錄,以Branch/Tag的根目錄為父目錄,例如您的Branch為Master,您的Dockerfile文件放在Master下,則您的Dockerfile目錄為Master/Dockerfile。
Dockerfile文件名
設置Dockerfile文件名,默認為Dockerfile。
鏡像版本
設置鏡像Tag,例如latest。
步驟四:構建鏡像
登錄容器鏡像服務控制臺。
在頂部菜單欄,選擇所需地域。
在左側導航欄,選擇實例列表。
在實例列表頁面單擊個人版實例。
在個人版實例管理頁面選擇
。在鏡像倉庫頁面,單擊目標倉庫右側操作列的管理。
在鏡像倉庫詳情頁面,單擊左側導航欄中的構建。
在構建規則設置區域,單擊目標規則操作列中的立即構建。
構建完成后,生成新的構建記錄。
說明單擊構建記錄右側操作列下的日志,可以查看構建日志。
等待鏡像構建完成后,單擊左側菜單欄中的鏡像版本,查看已構建完成的鏡像列表。
如果您需要查看所有鏡像,請單擊左側導航欄中的構建,在構建設置中開啟海外機器構建和不使用緩存,默認開啟代碼變更自動構建鏡像,然后單擊左側菜單欄中的鏡像版本,可以看到所有鏡像版本。