御用小本本

結論

1. Fine-grained Personal Access Tokens (github.com)
2. 從個人設定>開發人員設定>Personal access tokens (PAT) > Fine-grained tokens > 建立新 Token
   • Resource owner > 組織/個人 (視子模組是放在組織或個人選擇對應資源擁有者)
   • Repository access>主倉儲與子模組 (找不到 repo 可能是上模的組織擁有者選錯了)
   • Permissions>Repository permissions> Contents, Metadata > 唯讀權限
3. 從主倉儲>設定>環境(Environments)>Environment secrets>Add secret>將 PAT token 設定進去
4. 將 workflow 的 .yml 中指定環境>簽出子模組>設定 Token ( token: ${{ secrets.PAT_TOKEN }} )

jobs:
  build:
    runs-on: ubuntu-latest
    environment: develop  # 指定 environment 为 develop

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          submodules: recursive
          token: ${{ secrets.PAT_TOKEN }}

組織

也可以設定成組織通用 Secret，就不用每個 repo 都在建立一次 Secret 來將 PAT 寫進去

如果要由子模組更新來觸發主 repo CI/CD，可以把主倉儲 workflow 的 .yml 複製一份到子模組

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          repository: 組織名稱/Repo名稱
          submodules: recursive
          token: ${{ secrets.OAT_TOKEN }}

由於設定了 repository: 組織名稱/Repo名稱 觸發後會遷出指定主 repo 來做一次建置與發佈

Azure 

如果是從 Azure Web App Service 部屬中心設定過 Github CI/CD

那麼會發現 workflow 的 .yml 最後的 Deploy 會用到一個 secrets名為 AZUREAPPSERVICE_PUBLISHPROFILE_xxxxx

如果要讓子模組也可以發布到 Azure

1. 到 Azure Web App Service 下載發行設定檔
2. 到子模組 repo 新增設定 secret AZUREAPPSERVICE_PUBLISHPROFILE_xxxxx
3. 將下載回來的 profile.publishsettings 內容全部複製到 AZUREAPPSERVICE_PUBLISHPROFILE_xxxxx 的 Value 內

- name: 'Deploy to Azure Web App'
	uses: azure/webapps-deploy@v2
	id: deploy-to-webapp
	with:
		app-name: 'ai-nb-thermal'
		slot-name: 'develop'
		publish-profile: ${{ secrets.AZUREAPPSERVICE_PUBLISHPROFILE_xxxxx }}

參照

git - How to checkout submodule in GitHub action? - Stack Overflow