[ci] deploy api docs from github actions

.github/workflows/main.yml

@@ -230,6 +230,12 @@ jobs:
           ldd -v ./haxe
           ldd -v ./haxelib
       
+      # https://stackoverflow.com/questions/58033366/how-to-get-current-branch-within-github-actions
+      - name: Extract branch name
+        id: extract_branch
+        shell: bash
+        run: echo "##[set-output name=branch;]$(echo ${GITHUB_REF#refs/heads/})"
+      
       - name: Build xmldoc
         run: |
           set -ex
@@ -237,10 +243,16 @@ jobs:
           cat >extra/doc/info.json <<EOL
             {
               "commit": "$GITHUB_SHA",
-              "branch": "$GITHUB_REF"
+              "branch": "${{ steps.extract_branch.outputs.branch }}"
             }
           EOL
       
+      - name: Upload xmldoc artifact
+        uses: actions/[email protected]
+        with:
+          name: xmldoc
+          path: extra/doc
+      
       - name: Upload artifact
         uses: actions/[email protected]
         with:
@@ -715,3 +727,41 @@ jobs:
           aws s3 cp ${HXBUILDS_S3ADDR}/haxe/windows64-choco/${FILE_NAME} ${HXBUILDS_S3ADDR}/haxe/windows64-choco/haxe_latest.nupkg --acl public-read --website-redirect "${HXBUILDS_S3PATH}/haxe/windows64-choco/${FILE_NAME}"
           [[ `echo win32Binaries/*.nupkg` =~ win32Binaries/(.+) ]] && FILE_NAME="${BASH_REMATCH[1]}"
           aws s3 cp ${HXBUILDS_S3ADDR}/haxe/windows-choco/${FILE_NAME}   ${HXBUILDS_S3ADDR}/haxe/windows-choco/haxe_latest.nupkg   --acl public-read --website-redirect "${HXBUILDS_S3PATH}/haxe/windows-choco/${FILE_NAME}"
+
+  deploy_apidoc:
+    if: github.event_name != 'pull_request' # TODO: also only when `GHP_REMOTE` is present
+    needs: [linux-test, mac-test, windows-test, windows64-test]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download Haxe
+        uses: actions/download-artifact@v2
+        with:
+          name: linuxBinaries
+          path: linuxBinaries
+
+      - name: Setup Haxe
+        run: |
+          set -ex
+          tar -xf linuxBinaries/*_bin.tar.gz -C linuxBinaries --strip-components=1
+          sudo mkdir -p /usr/local/bin/
+          sudo mkdir -p /usr/local/share/haxe/
+          sudo ln -s `pwd`/linuxBinaries/haxe /usr/local/bin/haxe
+          sudo ln -s `pwd`/linuxBinaries/haxelib /usr/local/bin/haxelib
+          sudo ln -s `pwd`/linuxBinaries/std /usr/local/share/haxe/std
+
+      - name: Download xmldoc artifact
+        uses: actions/download-artifact@v2
+        with:
+          name: xmldoc
+          path: xmldoc
+
+      - name: Deploy to api.haxe.org
+        env:
+          GHP_EMAIL: [email protected]
+          GHP_USERNAME: Haxe CI Bot
+          GHP_REMOTE: ${{ secrets.GHP_REMOTE }}
+        run: |
+          set -ex
+          LOCAL="`pwd`/extra/api.haxe.org"
+          git clone "${GHP_REMOTE}" "${LOCAL}"
+          haxe --cwd "${LOCAL}" --run ImportXml "`pwd`/xmldoc"

azure-pipelines.yml

@@ -278,40 +278,3 @@ stages:
               AWS_SECRET_ACCESS_KEY: $(HXBUILDS_AWS_SECRET_ACCESS_KEY)
             condition: and(succeeded(), eq(variables['Build.SourceBranchName'], 'development'))
             displayName: Update "latest"
-
-      - job: ApiHaxeOrg
-        condition: and(succeeded(), variables['GHP_USERNAME'], variables['GHP_EMAIL'])
-        pool:
-          vmImage: 'ubuntu-16.04'
-        steps:
-          - checkout: none
-          - template: extra/azure-pipelines/install-neko-snapshot.yaml
-            parameters:
-              platform: linux64
-          - task: DownloadPipelineArtifact@0
-            inputs:
-              artifactName: 'linuxBinaries'
-              targetPath: linuxBinaries
-            displayName: Download linuxBinaries
-          - script: |
-              set -ex
-              tar -xf linuxBinaries/*_bin.tar.gz -C linuxBinaries --strip-components=1
-              sudo mkdir -p /usr/local/bin/
-              sudo mkdir -p /usr/local/share/haxe/
-              sudo ln -s `pwd`/linuxBinaries/haxe /usr/local/bin/haxe
-              sudo ln -s `pwd`/linuxBinaries/haxelib /usr/local/bin/haxelib
-              sudo ln -s `pwd`/linuxBinaries/std /usr/local/share/haxe/std
-            displayName: Setup Haxe
-          - task: DownloadPipelineArtifact@0
-            inputs:
-              artifactName: 'xmldoc'
-              targetPath: xmldoc
-            displayName: Download xmldoc
-          - script: |
-              set -ex
-              LOCAL="`pwd`/extra/api.haxe.org"
-              git clone "${GHP_REMOTE}" "${LOCAL}"
-              haxe --cwd "${LOCAL}" --run ImportXml "`pwd`/xmldoc"
-            env:
-              GHP_REMOTE: $(GHP_REMOTE)
-            displayName: Deploy to api.haxe.org

extra/github-actions/build-linux.yml

@@ -27,6 +27,12 @@
     ldd -v ./haxe
     ldd -v ./haxelib
 
+# https://stackoverflow.com/questions/58033366/how-to-get-current-branch-within-github-actions
+- name: Extract branch name
+  id: extract_branch
+  shell: bash
+  run: echo "##[set-output name=branch;]$(echo ${GITHUB_REF#refs/heads/})"
+
 - name: Build xmldoc
   run: |
     set -ex
@@ -34,10 +40,16 @@
     cat >extra/doc/info.json <<EOL
       {
         "commit": "$GITHUB_SHA",
-        "branch": "$GITHUB_REF"
+        "branch": "${{ steps.extract_branch.outputs.branch }}"
       }
     EOL
 
+- name: Upload xmldoc artifact
+  uses: actions/[email protected]
+  with:
+    name: xmldoc
+    path: extra/doc
+
 - name: Upload artifact
   uses: actions/[email protected]
   with:

extra/github-actions/workflows/main.yml

@@ -259,3 +259,41 @@ jobs:
           aws s3 cp ${HXBUILDS_S3ADDR}/haxe/windows64-choco/${FILE_NAME} ${HXBUILDS_S3ADDR}/haxe/windows64-choco/haxe_latest.nupkg --acl public-read --website-redirect "${HXBUILDS_S3PATH}/haxe/windows64-choco/${FILE_NAME}"
           [[ `echo win32Binaries/*.nupkg` =~ win32Binaries/(.+) ]] && FILE_NAME="${BASH_REMATCH[1]}"
           aws s3 cp ${HXBUILDS_S3ADDR}/haxe/windows-choco/${FILE_NAME}   ${HXBUILDS_S3ADDR}/haxe/windows-choco/haxe_latest.nupkg   --acl public-read --website-redirect "${HXBUILDS_S3PATH}/haxe/windows-choco/${FILE_NAME}"
+
+  deploy_apidoc:
+    if: github.event_name != 'pull_request' # TODO: also only when `GHP_REMOTE` is present
+    needs: [linux-test, mac-test, windows-test, windows64-test]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download Haxe
+        uses: actions/download-artifact@v2
+        with:
+          name: linuxBinaries
+          path: linuxBinaries
+
+      - name: Setup Haxe
+        run: |
+          set -ex
+          tar -xf linuxBinaries/*_bin.tar.gz -C linuxBinaries --strip-components=1
+          sudo mkdir -p /usr/local/bin/
+          sudo mkdir -p /usr/local/share/haxe/
+          sudo ln -s `pwd`/linuxBinaries/haxe /usr/local/bin/haxe
+          sudo ln -s `pwd`/linuxBinaries/haxelib /usr/local/bin/haxelib
+          sudo ln -s `pwd`/linuxBinaries/std /usr/local/share/haxe/std
+
+      - name: Download xmldoc artifact
+        uses: actions/download-artifact@v2
+        with:
+          name: xmldoc
+          path: xmldoc
+
+      - name: Deploy to api.haxe.org
+        env:
+          GHP_EMAIL: [email protected]
+          GHP_USERNAME: Haxe CI Bot
+          GHP_REMOTE: ${{ secrets.GHP_REMOTE }}
+        run: |
+          set -ex
+          LOCAL="`pwd`/extra/api.haxe.org"
+          git clone "${GHP_REMOTE}" "${LOCAL}"
+          haxe --cwd "${LOCAL}" --run ImportXml "`pwd`/xmldoc"