倉庫資訊
每個倉庫都可以包含描述、概覽和分類,以幫助使用者理解其用途和用法。新增清晰的倉庫資訊可以確保其他人能夠找到您的映象並有效地使用它們。
您只能修改未歸檔倉庫的倉庫資訊。如果倉庫已歸檔,您必須將其取消歸檔才能修改資訊。有關更多詳細資訊,請參閱取消歸檔倉庫。
倉庫描述
使用docker search
命令時,描述會出現在搜尋結果中,並顯示在 Docker Hub 的搜尋結果中。
請考慮以下倉庫描述最佳實踐。
- 總結用途。清晰、簡潔、具體地說明映象的功能。明確它是用於特定應用程式、工具、平臺還是具有獨特用例。
- 突出關鍵特性或優勢。簡要提及區分該映象的主要優勢或獨特功能。示例包括高效能、易用性、輕量級構建或與特定框架或作業系統的相容性。
- 包含相關關鍵詞。使用使用者可能會搜尋的關鍵詞來提高可見性,例如技術棧、用例或環境。
- 保持簡潔。描述最多可包含 100 個字元。描述最好保持在一兩句話之內,以確保在搜尋結果中易於閱讀。使用者應快速瞭解映象的價值。
- 關注受眾。考慮您的目標受眾(開發者、系統管理員等),並編寫描述以直接滿足他們的需求。
遵循這些實踐可以幫助使描述在搜尋結果中更具吸引力和有效性,從而為您的倉庫帶來更多相關流量。
新增或更新倉庫描述
登入 Docker Hub。
選擇 My Hub > Repositories。
將顯示您的倉庫列表。
選擇一個倉庫。
將顯示倉庫的General頁面。
選擇描述欄位下的鉛筆圖示。
指定描述。
描述最長可達 100 個字元。
選擇更新。
倉庫概覽
概覽描述了您的映象功能以及如何執行它。當倉庫至少有一個映象時,它會顯示在倉庫的公共檢視中。如果啟用了自動構建,概覽將在每次成功構建時從原始碼倉庫的README.md
檔案同步。
請考慮以下倉庫概覽最佳實踐。
- 描述映象是什麼、它提供了哪些功能以及為什麼應該使用它。可以包括使用示例或專案背後的團隊。
- 解釋如何開始使用映象執行容器。您可以包含一個在 Dockerfile 中使用映象的最小示例。
- 列出關鍵的映象變體和用於它們的標籤,以及變體的用例。
- 連結到文件或支援網站、社群或郵件列表以獲取更多資源。
- 提供映象維護者的聯絡資訊。
- 包含映象的許可證以及在需要時查詢更多詳細資訊的位置。
新增或更新倉庫概覽
登入 Docker Hub。
選擇 My Hub > Repositories。
將顯示您的倉庫列表。
選擇一個倉庫。
將顯示倉庫的General頁面。
在倉庫概覽下,選擇編輯或新增概覽。
將出現寫入和預覽選項卡。
在寫入下,指定您的倉庫概覽。
您可以使用基本的 Markdown,並使用預覽選項卡預覽格式。
選擇更新。
倉庫分類
您可以使用類別標記 Docker Hub 倉庫,這些類別代表了您映象的主要預期用例。這使使用者可以更輕鬆地找到和探索他們感興趣的問題領域的內容。
可用分類
Docker Hub 內容團隊維護著一份精選的類別列表。
類別包括
- API 管理:用於建立、釋出、分析和保護 API 的工具。
- 內容管理系統:透過模板、程式和標準格式建立和管理數字內容的軟體應用程式。
- 資料科學:支援資料分析和生成可操作洞察的工具和軟體。
- 資料庫和儲存:用於儲存、檢索和管理資料的系統。
- 語言和框架:程式語言執行時和框架。
- 整合和交付:用於持續整合 (CI) 和持續交付 (CD) 的工具。
- 物聯網:支援物聯網 (IoT) 應用程式的工具。
- 機器學習和 AI:為人工智慧和機器學習專案最佳化的工具和框架,例如預裝的用於資料分析、模型訓練和部署的庫和框架。
- 訊息佇列:為可靠、可擴充套件和高效的訊息處理最佳化的訊息佇列系統。
- 監控和可觀測性:透過指標、日誌和跟蹤來跟蹤軟體和系統性能的工具,以及用於探索系統狀態和診斷問題的可觀測性工具。
- 網路:支援資料交換以及連線計算機和其他裝置以共享資源的倉庫。
- 作業系統:管理計算機上所有其他程式並充當使用者和計算機硬體之間中介的軟體,同時監督應用程式和系統資源。
- 安全:用於保護計算機系統或網路免受盜竊、未經授權的訪問或硬體、軟體或電子資料損壞以及服務中斷的工具。
- Web 伺服器:向用戶或其他系統提供網頁、HTML 檔案和其他資產的軟體。
- Web 分析:收集、測量、分析和報告網路資料和網站訪問者參與度的工具。
自動生成分類
注意自動生成的分類僅適用於 Docker 驗證釋出者和 Docker 贊助開源計劃參與者。
對於早於 Docker Hub 中的“類別”功能的倉庫,已使用 OpenAI 根據倉庫標題和描述自動生成並應用了類別。
作為已自動分類倉庫的所有者,如果您認為類別不準確,可以手動編輯類別。請參閱管理倉庫類別。
自動分類是一次性工作,旨在為在該功能存在之前建立的倉庫提供類別。新倉庫不會自動分配類別。
管理倉庫分類
您可以為倉庫新增最多三個類別。
編輯倉庫類別
登入 Docker Hub。
選擇 My Hub > Repositories。
將顯示您的倉庫列表。
選擇一個倉庫。
將顯示倉庫的General頁面。
選擇描述欄位下的鉛筆圖示。
選擇您要應用的類別。
選擇更新。
如果您缺少某個類別,請使用提供反饋連結,告訴我們您希望看到哪些類別。