This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Vercel deployment preview link generator | |
| on: | |
| pull_request: | |
| types: [opened, synchronize] | |
| paths: | |
| - 'website/docs/docs/**' | |
| - 'website/docs/best-practices/**' | |
| - 'website/docs/guides/**' | |
| - 'website/docs/faqs/**' | |
| - 'website/docs/reference/**' | |
| permissions: | |
| contents: read | |
| pull-requests: write | |
| jobs: | |
| comment-deployment-link: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout code | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 | |
| - name: Install necessary tools | |
| run: | | |
| sudo apt-get update | |
| sudo apt-get install -y jq curl | |
| - name: Generate Vercel deployment URL | |
| id: vercel_url | |
| run: | | |
| # Get the branch name | |
| BRANCH_NAME="${{ github.head_ref }}" | |
| # Convert to lowercase | |
| BRANCH_NAME_LOWER=$(echo "$BRANCH_NAME" | tr '[:upper:]' '[:lower:]') | |
| # Replace non-alphanumeric characters with hyphens | |
| BRANCH_NAME_SANITIZED=$(echo "$BRANCH_NAME_LOWER" | sed 's/[^a-z0-9]/-/g') | |
| # Construct the deployment URL | |
| DEPLOYMENT_URL="https://docs-getdbt-com-git-${BRANCH_NAME_SANITIZED}-dbt-labs.vercel.app" | |
| echo "deployment_url=$DEPLOYMENT_URL" >> $GITHUB_OUTPUT | |
| - name: Wait for deployment to be accessible | |
| id: wait_for_deployment | |
| run: | | |
| DEPLOYMENT_URL="${{ steps.vercel_url.outputs.deployment_url }}" | |
| echo "Waiting for deployment at $DEPLOYMENT_URL to become accessible..." | |
| MAX_ATTEMPTS=60 # Adjust as needed (e.g., wait up to 10 minutes) | |
| SLEEP_TIME=10 # Check every 10 seconds | |
| ATTEMPTS=0 | |
| while [ $ATTEMPTS -lt $MAX_ATTEMPTS ]; do | |
| STATUS_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$DEPLOYMENT_URL") | |
| if [ "$STATUS_CODE" -eq 200 ]; then | |
| echo "Deployment is accessible." | |
| break | |
| else | |
| echo "Deployment not yet accessible (status code: $STATUS_CODE). Waiting..." | |
| sleep $SLEEP_TIME | |
| ATTEMPTS=$((ATTEMPTS + 1)) | |
| fi | |
| done | |
| if [ $ATTEMPTS -eq $MAX_ATTEMPTS ]; then | |
| echo "Deployment did not become accessible within the expected time." | |
| exit 1 | |
| fi | |
| - name: Get changed files | |
| id: files | |
| run: | | |
| # Get the list of changed files in the specified directories | |
| CHANGED_FILES=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.sha }} | grep -E '^website/docs/(docs|best-practices|guides|faqs|reference)/.*\.md$' || true) | |
| echo "Changed files:" | |
| echo "$CHANGED_FILES" | |
| # Check if any files were changed | |
| if [ -z "$CHANGED_FILES" ]; then | |
| echo "No documentation files were changed." | |
| echo "changed_files=" >> $GITHUB_OUTPUT | |
| else | |
| # Convert line-separated files to space-separated for easier handling | |
| CHANGED_FILES="$(echo "$CHANGED_FILES" | tr '\n' ' ')" | |
| echo "changed_files=$CHANGED_FILES" >> $GITHUB_OUTPUT | |
| fi | |
| - name: Generate file preview links | |
| id: links | |
| run: | | |
| DEPLOYMENT_URL="${{ steps.vercel_url.outputs.deployment_url }}" | |
| CHANGED_FILES="${{ steps.files.outputs.changed_files }}" | |
| if [ -z "$CHANGED_FILES" ]; then | |
| echo "No documentation files were changed." | |
| LINKS="- No documentation files were changed." | |
| else | |
| LINKS="" | |
| for FILE in $CHANGED_FILES; do | |
| # Remove 'website/docs/' prefix and '.md' extension | |
| FILE_PATH="${FILE#website/docs/}" | |
| FILE_PATH="${FILE_PATH%.md}" | |
| # Replace spaces and special characters with hyphens in URL path | |
| URL_PATH=$(echo "$FILE_PATH" | sed 's/ /-/g; s/[^a-zA-Z0-9\-\/]//g' | tr '[:upper:]' '[:lower:]') | |
| FULL_URL="$DEPLOYMENT_URL/$URL_PATH" | |
| LINKS="$LINKS\n- [$FULL_URL]($FULL_URL)" | |
| done | |
| fi | |
| # Output the links | |
| echo -e "links=$LINKS" >> $GITHUB_OUTPUT | |
| - name: Post comment with deployment link | |
| uses: peter-evans/create-or-update-comment@v4 | |
| with: | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| issue-number: ${{ github.event.pull_request.number }} | |
| body: | | |
| 🚀 Deployment available! Here are the direct links to the updated files: | |
| ${{ steps.links.outputs.links }} |