CI: Remove docs build from pipelines (#32074)

Author: datapythonista

.github/workflows/ci.yml

@@ -154,6 +154,39 @@ jobs:
         echo "region = BHS" >> $RCLONE_CONFIG_PATH
       if: github.event_name == 'push'
 
-    - name: Sync web
+    - name: Sync web with OVH
       run: rclone sync pandas_web ovh_cloud_pandas_web:dev
       if: github.event_name == 'push'
+
+    - name: Create git repo to upload the built docs to GitHub pages
+      run: |
+        cd pandas_web
+        git init
+        touch .nojekyll
+        echo "dev.pandas.io" > CNAME
+        printf "User-agent: *\nDisallow: /" > robots.txt
+        git add --all .
+        git config user.email "[email protected]"
+        git config user.name "pandas-bot"
+        git commit -m "pandas web and documentation in master"
+      if: github.event_name == 'push'
+
+    # For this task to work, next steps are required:
+    # 1. Generate a pair of private/public keys (i.e. `ssh-keygen -t rsa -b 4096 -C "[email protected]"`)
+    # 2. Go to https://github.com/pandas-dev/pandas/settings/secrets
+    # 3. Click on "Add a new secret"
+    # 4. Name: "github_pagas_ssh_key", Value: <Content of the private ssh key>
+    # 5. The public key needs to be upladed to https://github.com/pandas-dev/pandas-dev.github.io/settings/keys
+    - name: Install GitHub pages ssh deployment key
+      uses: shimataro/ssh-key-action@v2
+      with:
+        key: ${{ secrets.github_pages_ssh_key }}
+        known_hosts: 'github.com,192.30.252.128 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAq2A7hRGmdnm9tUDbO9IDSwBK6TbQa+PXYPCPy6rbTrTtw7PHkccKrpp0yVhp5HdEIcKr6pLlVDBfOLX9QUsyCOV0wzfjIJNlGEYsdlLJizHhbn2mUjvSAHQqZETYP81eFzLQNnPHt4EVVUh7VfDESU84KezmD5QlWpXLmvU31/yMf+Se8xhHTvKSCZIFImWwoG6mbUoWf9nzpIoaSjB+weqqUUmpaaasXVal72J+UX2B+2RPW3RcT0eOzQgqlJL3RKrTJvdsjE3JEAvGq3lGHSZXy28G3skua2SmVi/w4yCE6gbODqnTWlg7+wC604ydGXA8VJiS5ap43JXiUFFAaQ=='
+      if: github.event_name == 'push'
+
+    - name: Publish web and docs to GitHub pages
+      run: |
+        cd pandas_web
+        git remote add origin [email protected]:pandas-dev/pandas-dev.github.io.git
+        git push -f origin master
+      if: github.event_name == 'push'

azure-pipelines.yml

@@ -15,78 +15,3 @@ jobs:
   parameters:
     name: Windows
     vmImage: vs2017-win2016
-
-- job: 'Web_and_Docs'
-  pool:
-    vmImage: ubuntu-16.04
-  timeoutInMinutes: 90
-  steps:
-  - script: |
-      echo '##vso[task.setvariable variable=ENV_FILE]environment.yml'
-      echo '##vso[task.prependpath]$(HOME)/miniconda3/bin'
-    displayName: 'Setting environment variables'
-
-  - script: |
-      sudo apt-get install -y libc6-dev-i386
-      ci/setup_env.sh
-    displayName: 'Setup environment and build pandas'
-
-  - script: |
-      source activate pandas-dev
-      python web/pandas_web.py web/pandas --target-path=web/build
-    displayName: 'Build website'
-
-  - script: |
-      source activate pandas-dev
-      # Next we should simply have `doc/make.py --warnings-are-errors`, everything else is required because the ipython directive doesn't fail the build on errors (https://github.com/ipython/ipython/issues/11547)
-      doc/make.py --warnings-are-errors | tee sphinx.log ; SPHINX_RET=${PIPESTATUS[0]}
-      grep -B1 "^<<<-------------------------------------------------------------------------$" sphinx.log ; IPY_RET=$(( $? != 1 ))
-      exit $(( $SPHINX_RET + $IPY_RET ))
-    displayName: 'Build documentation'
-
-  - script: |
-      mkdir -p to_deploy/docs
-      cp -r web/build/* to_deploy/
-      cp -r doc/build/html/* to_deploy/docs/
-    displayName: 'Merge website and docs'
-
-  - script: |
-      cd to_deploy
-      git init
-      touch .nojekyll
-      echo "dev.pandas.io" > CNAME
-      printf "User-agent: *\nDisallow: /" > robots.txt
-      git add --all .
-      git config user.email "[email protected]"
-      git config user.name "pandas-bot"
-      git commit -m "pandas web and documentation in master"
-    displayName: 'Create git repo for docs build'
-    condition : |
-      and(not(eq(variables['Build.Reason'], 'PullRequest')),
-          eq(variables['Build.SourceBranch'], 'refs/heads/master'))
-
-  # For `InstallSSHKey@0` to work, next steps are required:
-  # 1. Generate a pair of private/public keys (i.e. `ssh-keygen -t rsa -b 4096 -C "[email protected]"`)
-  # 2. Go to "Library > Secure files" in the Azure Pipelines dashboard: https://dev.azure.com/pandas-dev/pandas/_library?itemType=SecureFiles
-  # 3. Click on "+ Secure file"
-  # 4. Upload the private key (the name of the file must match with the specified in "sshKeySecureFile" input below, "pandas_docs_key")
-  # 5. Click on file name after it is created, tick the box "Authorize for use in all pipelines" and save
-  # 6. The public key specified in "sshPublicKey" is the pair of the uploaded private key, and needs to be set as a deploy key of the repo where the docs will be pushed (with write access): https://github.com/pandas-dev/pandas-dev.github.io/settings/keys
-  - task: InstallSSHKey@0
-    inputs:
-      hostName: 'github.com,192.30.252.128 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAq2A7hRGmdnm9tUDbO9IDSwBK6TbQa+PXYPCPy6rbTrTtw7PHkccKrpp0yVhp5HdEIcKr6pLlVDBfOLX9QUsyCOV0wzfjIJNlGEYsdlLJizHhbn2mUjvSAHQqZETYP81eFzLQNnPHt4EVVUh7VfDESU84KezmD5QlWpXLmvU31/yMf+Se8xhHTvKSCZIFImWwoG6mbUoWf9nzpIoaSjB+weqqUUmpaaasXVal72J+UX2B+2RPW3RcT0eOzQgqlJL3RKrTJvdsjE3JEAvGq3lGHSZXy28G3skua2SmVi/w4yCE6gbODqnTWlg7+wC604ydGXA8VJiS5ap43JXiUFFAaQ=='
-      sshPublicKey: 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDHmz3l/EdqrgNxEUKkwDUuUcLv91unig03pYFGO/DMIgCmPdMG96zAgfnESd837Rm0wSSqylwSzkRJt5MV/TpFlcVifDLDQmUhqCeO8Z6dLl/oe35UKmyYICVwcvQTAaHNnYRpKC5IUlTh0JEtw9fGlnp1Ta7U1ENBLbKdpywczElhZu+hOQ892zqOj3CwA+U2329/d6cd7YnqIKoFN9DWT3kS5K6JE4IoBfQEVekIOs23bKjNLvPoOmi6CroAhu/K8j+NCWQjge5eJf2x/yTnIIP1PlEcXoHIr8io517posIx3TBup+CN8bNS1PpDW3jyD3ttl1uoBudjOQrobNnJeR6Rn67DRkG6IhSwr3BWj8alwUG5mTdZzwV5Pa9KZFdIiqX7NoDGg+itsR39QCn0thK8lGRNSR8KrWC1PSjecwelKBO7uQ7rnk/rkrZdBWR4oEA8YgNH8tirUw5WfOr5a0AIaJicKxGKNdMxZt+zmC+bS7F4YCOGIm9KHa43RrKhoGRhRf9fHHHKUPwFGqtWG4ykcUgoamDOURJyepesBAO3FiRE9rLU6ILbB3yEqqoekborHmAJD5vf7PWItW3Q/YQKuk3kkqRcKnexPyzyyq5lUgTi8CxxZdaASIOu294wjBhhdyHlXEkVTNJ9JKkj/obF+XiIIp0cBDsOXY9hDQ== [email protected]'
-      sshKeySecureFile: 'pandas_docs_key'
-    displayName: 'Install GitHub ssh deployment key'
-    condition : |
-      and(not(eq(variables['Build.Reason'], 'PullRequest')),
-          eq(variables['Build.SourceBranch'], 'refs/heads/master'))
-
-  - script: |
-      cd to_deploy
-      git remote add origin [email protected]:pandas-dev/pandas-dev.github.io.git
-      git push -f origin master
-    displayName: 'Publish web and docs to GitHub pages'
-    condition : |
-      and(not(eq(variables['Build.Reason'], 'PullRequest')),
-          eq(variables['Build.SourceBranch'], 'refs/heads/master'))