重新命名專案中的 Git 存放庫

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

Visual Studio 2019 |Visual Studio 2022

您可以從網頁瀏覽器重新命名專案中的 Git 存放庫。重新命名存放庫之後，小組的每個成員都應該採取幾個步驟，重新啟用其開發機器以連線到伺服器上的存放庫。

必要條件

類別	需求
專案存取	專案的成員。
許可	- 在私人項目中檢視程式碼：至少基本權限。 - 複製或貢獻私人專案中的程式碼：作為貢獻者安全群組的成員或在專案中具有相應的許可權。 - 設定分支或存放庫許可權：管理分支或存放庫的許可權許可權。 - 變更預設分支：編輯原則存放庫的許可權。 - 匯入存放庫：專案管理員成員安全組或 Git 專案層級建立存放庫許可權設定為允許。如需詳細資訊，請參閱設定 Git 存放庫許可權。
服務	啟用 Repos。
工具	選擇性。使用 az repos 命令：Azure DevOps CLI。

備註

在公用專案中，具有 項目關係人 存取權的使用者具有 Azure Repos 的完整存取權，包括檢視、複製及參與程式代碼。

類別	需求
專案存取	專案的成員。
許可	- 查看程式碼：至少基本權限。 - 複製程式碼或貢獻程式碼：屬於參與者安全組的成員或具有專案中的對應許可權。
服務	啟用 Repos。

從網路入口選取 [存放庫]、[檔案]。
從存放庫下拉式清單中，選取 [ 管理存放庫]。
從 [存放庫 ] 列表中選取存放庫的名稱，選擇 [...] 功能表，然後選擇 [ 重新命名存放庫]。
輸入存放庫的新名稱並選取 [重新命名]，以重新命名存放庫。

您可以使用 az repos update 來更新預設分支或重新命名存放庫。

az repos show --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]
                [--subscription]

參數

參數	描述
`repository`	存放庫的名稱或標識碼。
`default-branch`	指定要為存放庫設定的預設分支。範例：'refs/heads/live' 或 'live'。
`detect`	自動偵測組織。接受的值： `false`、 `true`。
`name`	存放庫的新名稱。
`org`、`organization`	Azure DevOps 組織 URL。您可以使用 `az devops configure -d organization=<ORG_URL>` 來設定預設組織。如果未設定為預設值或未通過 git config 取得，則為必要。範例：`https://dev.azure.com/MyOrganizationName/`。
`project`、`p`	項目的名稱或識別碼。您可以使用 `az devops configure -d project=<NAME_OR_ID>` 來設定預設的專案。如果未設定為預設或未透過 git config 選取，則為必要。
`subscription`	訂用帳戶的名稱或識別碼。您可以使用 `az account set -s <NAME_OR_ID>` 設定預設訂用帳戶。

範例

下列命令會將預設組態的 contosoREPO 重新命名為 contosoFabrikam。az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

如需詳細資訊，請輸入下列命令：

az repos update --repository contosoREPO --name contosoFabrikam
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoFabrikam",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/Fabrikam%20Fiber/contosoFabrikam",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam"
}

Azure DevOps Server 不支援 Azure DevOps CLI 命令。

更新您的開發環境中的 Git 遠端設定

Git 使用遠端引用來擷取和推送本機儲存庫與儲存在伺服器上的遠端版本之間的變更。在 Git 存放庫或專案重新命名之後，您應該更新遠端參考。更新你的參考，使遠端存放庫的 URL 包含專案和存放庫名稱。

小組的每個成員都必須更新其本機 Git 存放庫，才能繼續從其開發機器連線到專案中的存放庫。下列指示說明如何更新名為 Fabrikam Mobile 並已重新命名為 Fabrikam 的存放庫的遠端。

取得存放庫的新 URL

選取 存放庫, 檔案。
在檔案視窗的右上角選擇複製並複製克隆 URL。

在 Visual Studio 中更新遠端

若要更新您的遙控器：

在功能表欄的 [Git] 選單中，選取 [管理遠端]。
在 [ 選項] 對話框中，選取要編輯的遠端，然後選取 [ 編輯]。
將提取和推送的遠端指標替換為您從遠端存放庫複製的 URL。
選取 [儲存]，然後選取 [確定] 以關閉 [選項] 對話框。

Visual Studio 2019 16.8 版和更新版本提供 Git 版本控制體驗，同時維護 Team Explorer Git 使用者介面。若要使用Team Explorer，請從功能表列取消核取 [工具][選項>][預覽功能] 下的 [新增 Git 使用者體驗]。您可以從任一界面使用 Git 功能。

若要從 Visual Studio Team Explorer 中更新您的遠端：