使用 CircleCI 工作流管理 Spaces

你可以使用 CircleCI 工作流讓你的應用與 GitHub 倉庫保持同步。

CircleCI 是一個持續整合和持續交付 (CI/CD) 平臺，有助於自動化軟體開發過程。CircleCI 工作流是在配置檔案中定義的一組自動化任務，由 CircleCI 編排，以簡化構建、測試和部署軟體應用程式的過程。

注意：對於大於 10MB 的檔案，Spaces 需要 Git-LFS。如果你不想使用 Git-LFS，你可能需要檢查你的檔案和歷史記錄。使用 BFG Repo-Cleaner 等工具從你的歷史記錄中刪除任何大檔案。BFG Repo-Cleaner 會在本地保留你的倉庫副本作為備份。

首先，將你的 GitHub 倉庫和 Spaces 應用設定在一起。將你的 Spaces 應用新增為你現有 Git 倉庫的額外遠端倉庫。

git remote add space https://huggingface.co/spaces/HF_USERNAME/SPACE_NAME

然後強制推送以首次同步所有內容

git push --force space main

接下來，設定一個 CircleCI 工作流，將你的 main git 分支推送到 Spaces。

在下面的示例中

將 HF_USERNAME 替換為你的使用者名稱，將 SPACE_NAME 替換為你的 Space 名稱。
在 CircleCI 中建立一個上下文，並在其中新增一個名為 HF_PERSONAL_TOKEN 的環境變數（你可以給它任何名稱，使用你建立的鍵代替 HF_PERSONAL_TOKEN），值為你的 Hugging Face API 令牌。你可以在你的 Hugging Face 個人資料中的API 令牌下找到你的 Hugging Face API 令牌。

version: 2.1

workflows:
  main:
    jobs:
      - sync-to-huggingface:
          context:
            - HuggingFace
          filters:
            branches:
              only:
                - main

jobs:
  sync-to-huggingface:
    docker:
      - image: alpine
    resource_class: small
    steps:
      - run: 
          name: install git
          command: apk update && apk add openssh-client git
      - checkout
      - run:
          name: push to Huggingface hub
          command: |
                  git config user.email "<your-email@here>" 
                  git config user.name "<your-identifier>" 
                  git push -f https://HF_USERNAME:${HF_PERSONAL_TOKEN}@huggingface.co/spaces/HF_USERNAME/SPACE_NAME main

< > 在 GitHub 上更新