fix(ci): fix docs deployment configuration

.github/workflows/ci-main.yml

@@ -69,7 +69,6 @@ jobs:
       - name: Cache workspace
         uses: Swatinem/rust-cache@v2
         with:
-          key: ${{ steps.toolchain.outputs.cachekey }}
           workspaces: |
             ./substrate
             ./cargo-workspaces/cargo-workspaces

.github/workflows/deploy-api-docs.yml

@@ -17,30 +17,39 @@ jobs:
   deploy-api-docs:
     name: Deploy API documentation
     runs-on: ubuntu-latest
-    environment: docs
+    environment: main
     steps:
-      - uses: actions/checkout@v4
       - name: Install Protoc
         uses: arduino/setup-protoc@v2
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/checkout@v4
+        with:
+          path: main
+      - uses: actions/checkout@v4
+        with:
+          path: release
+          ref: refs/tags/release
       - uses: Swatinem/rust-cache@v2
         with:
-          key: ${{ steps.toolchain.outputs.cachekey }}
           workspaces: |
-            ${{ inputs.workspace_path }}
+            main
+            release
           cache-on-failure: true
       - uses: superfly/flyctl-actions/setup-flyctl@master
         with:
-          version: 0.3.66
+          version: 0.4.6
       - run: ./build.sh . ${{ inputs.name || github.ref_name }}
-        working-directory: docs/api
-      - uses: actions/checkout@v4
-        with:
-          ref: refs/tags/release
-      - run: ./build.sh . release
-        working-directory: docs/api
+        working-directory: main/docs/api
+      - run: ../../../main/docs/api/build.sh ../../../main/docs/api release
+        working-directory: release/docs/api
+        env:
+          # For backwards compatibility with compile-time environment variables.
+          OPEN_PDKS_ROOT: ""
+          SKY130_CDS_PDK_ROOT: ""
+      - run: echo "<meta http-equiv=\"refresh\" content=\"0; url=release/substrate\">" > ./static/index.html
+        working-directory: main/docs/api
       - run: flyctl deploy --remote-only --detach
-        working-directory: docs/api
+        working-directory: main/docs/api
         env:
           FLY_ACCESS_TOKEN: ${{ secrets.FLY_API_TOKEN_API }}

.github/workflows/deploy-docs.yml

@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: superfly/flyctl-actions/setup-flyctl@master
         with:
-          version: 0.3.66
+          version: 0.4.6
       - uses: actions/setup-node@v3
         with:
           node-version: 23.x

docs/api/.dockerignore

@@ -1,2 +1,2 @@
 *
-!target/doc
+!static

docs/api/.gitignore

@@ -1,2 +1,3 @@
 target/
+static/
 *.hidden

docs/api/Dockerfile

@@ -1,2 +1,2 @@
 FROM pierrezemb/gostatic
-COPY ./target/doc/ /srv/http/
+COPY ./static/ /srv/http/

docs/api/build.sh

@@ -16,7 +16,7 @@ REF_NAME=$2
 
 cargo d --no-deps --workspace --all-features --target-dir ./target --exclude tests --exclude examples
 echo "<meta http-equiv=\"refresh\" content=\"0; url=substrate\">" > ./target/doc/index.html
-rm -rf $PUBLIC_DOCS_DIR/api/static/$REF_NAME
-mkdir -p $PUBLIC_DOCS_DIR/api/static/$REF_NAME
-cp -r ./target/doc/. $PUBLIC_DOCS_DIR/api/static/$REF_NAME
-cd $PUBLIC_DOCS_DIR/api
+rm -rf $PUBLIC_DOCS_DIR/static/$REF_NAME
+mkdir -p $PUBLIC_DOCS_DIR/static/$REF_NAME
+cp -r ./target/doc/. $PUBLIC_DOCS_DIR/static/$REF_NAME
+cd $PUBLIC_DOCS_DIR

docs/docusaurus/deploy.sh

@@ -22,14 +22,14 @@ cat << EOF > ./site-config.json
 EOF
 yarn install --frozen-lockfile
 yarn build
-if [ $REF_NAME = "main" ]; then
-    find $PUBLIC_DOCS_DIR/docusaurus/static -maxdepth 1 -mindepth 1 -not -name "branch" -exec rm -r {} +
-    mkdir -p $PUBLIC_DOCS_DIR/docusaurus/static
-    cp -r ./build/. $PUBLIC_DOCS_DIR/docusaurus/static
-else
-    rm -rf $PUBLIC_DOCS_DIR/docusaurus/static/branch/$REF_NAME
-    mkdir -p $PUBLIC_DOCS_DIR/docusaurus/static/branch/$REF_NAME
-    cp -r ./build/. $PUBLIC_DOCS_DIR/docusaurus/static/branch/$REF_NAME
-fi
-cd $PUBLIC_DOCS_DIR/docusaurus
+# if [ $REF_NAME = "main" ]; then
+#     find $PUBLIC_DOCS_DIR/docusaurus/static -maxdepth 1 -mindepth 1 -not -name "branch" -exec rm -r {} +
+#     mkdir -p $PUBLIC_DOCS_DIR/docusaurus/static
+#     cp -r ./build/. $PUBLIC_DOCS_DIR/docusaurus/static
+# else
+#     rm -rf $PUBLIC_DOCS_DIR/docusaurus/static/branch/$REF_NAME
+#     mkdir -p $PUBLIC_DOCS_DIR/docusaurus/static/branch/$REF_NAME
+#     cp -r ./build/. $PUBLIC_DOCS_DIR/docusaurus/static/branch/$REF_NAME
+# fi
+# cd $PUBLIC_DOCS_DIR/docusaurus
 flyctl deploy --remote-only --detach