将项目从 git 子模块复制到 ADO 存储库

Question

我有一个 ADO 存储库，其中包含一个 GitHub 存储库作为 git 子模块。

以下是 ADO repo 中的 .csproj 文件示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
    <AzureFunctionsVersion>v3</AzureFunctionsVersion>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Azure.Functions.Extensions" Version="1.0.0" />
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="3.0.3" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\..\..\Repositories.ABC\Repositories.ABC.csproj" />
    <ProjectReference Include="..\..\..\Repositories.XYZ\Repositories.XYZ.csproj" />
  </ItemGroup>
</Project>

.csproj 中提到的项目引用 - Respositories.ABC 和 Repositories.XYZ 是 GitHub 存储库（git 子模块）的一部分。 有没有办法将项目 - Respositories.ABC 和 Repositories.XYZ 从 git 子模块复制到指定路径中的 ADO 存储库，这样构建就不会失败？

这是我的项目结构：

这是我的子模块结构：

Answer 1

是的，你应该启用获取submodules：

steps:
- checkout: self  # self represents the repo where the initial Pipelines YAML file was found
  clean: boolean  # whether to fetch clean each time
  fetchDepth: number  # the depth of commits to ask Git to fetch
  lfs: boolean  # whether to download Git-LFS files
  submodules: true | recursive  # set to 'true' for a single level of submodules or 'recursive' to get submodules of submodules
  path: string  # path to check out source code, relative to the agent's build directory (e.g. \_work\1)
  persistCredentials: boolean  # set to 'true' to leave the OAuth token in the Git config after the initial fetch

但是，如果您对子模块使用私有存储库并且不将它们保留在 Azure 存储库中，您可以检查一下 - Alternative to using the Checkout submodules option

在某些情况下，您不能使用 Checkout 子模块选项。您可能会遇到需要一组不同的凭据才能访问子模块的情况。例如，如果您的主存储库和子模块存储库未存储在同一个 Azure DevOps 组织中，或者您的作业访问令牌无权访问不同项目中的存储库，则可能会发生这种情况。

如果您不能使用 Checkout submodules 选项，那么您可以改为使用自定义脚本步骤来获取子模块。首先，获取个人访问令牌 (PAT) 并在其前面加上 pat:。接下来，对该前缀字符串进行 base64 编码以创建基本身份验证令牌。最后，将此脚本添加到您的管道中：

git -c http.https://<url of submodule repository>.extraheader="AUTHORIZATION: Bearer <BASE64_ENCODED_STRING>" submodule update --init --recursive

Answer 2

有没有办法将项目 - Respositories.ABC 和 Repositories.XYZ 从 git 子模块复制到指定路径中的 ADO 存储库，这样构建就不会失败？

恐怕没有办法将Github子模块复制到ADO仓库指定路径。

当我们将子模块添加到 ADO 存储库时，它会在 ADO 存储库.gitmodules 和项目名称文件中创建两个文件：

如果我们检出子模块，git 会根据.gitmodules 中的路径将项目保存到项目名称文件夹中。由于文件.gitmodules 和项目名称文件已添加到源代码管理中，因此默认签出。如果我们要更改路径，我们必须在结帐后手动更改路径。

为了确保构建成功，我们只需要确保ProjectReference在.csproj文件中的路径与repo中的文件结构匹配。

更新：

如果你的Cleaner.csproj文件所在的目录层次是这样的Service\Project\Hosts\Cleaner\Function\Cleaner.csproj，那么路径应该是：

<ProjectReference Include="..\..\..\..\..\crypto-project\Service.xxxx\Repositories.ABC\Repositories.ABC.csproj" />

路径应该是Cleaner.csproj和.gitmodules文件的相对位置，一个..\代表上一级目录，..\后面的路径应该是crypto-project+每一级目录文件夹。