Migrate docs workflows from preview-build to docs-actions#5618
Merged
Conversation
Replace the monolithic preview-build.yml caller with the new two-phase workflow architecture from elastic/docs-actions: - docs-build.yml (Phase 1): read-only build validation on PRs and push - docs-deploy.yml (Phase 2): privileged deploy via workflow_run - docs-preview-cleanup.yml: cleanup on PR close Removes the old docs-cleanup.yml that called docs-builder's preview-cleanup workflow. Part of elastic/docs-eng-team#474 Made-with: Cursor
reakaleek
reviewed
Mar 25, 2026
reakaleek
reviewed
Mar 25, 2026
reakaleek
reviewed
Mar 25, 2026
reakaleek
reviewed
Mar 25, 2026
Repos with restrictive default token permissions need the caller to explicitly grant what the reusable workflows require. Made-with: Cursor
The old preview-build.yml had enable-vale-linting: true. Phase 1 runs the linter, Phase 2 posts the report — both need the input. Made-with: Cursor
reakaleek
approved these changes
Mar 25, 2026
Made-with: Cursor
This reverts commit 346d8c8.
Mpdreamz
enabled auto-merge (squash)
March 25, 2026 14:29
Mpdreamz
added a commit
that referenced
this pull request
Mar 25, 2026
## Summary Adds `pull-requests: read` to the `docs-build.yml` permissions block. The reusable build workflow needs this for the changed-files check job to list PR files via the API. Follow-up to #5618. Made with [Cursor](https://cursor.com)
This file contains hidden or 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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Migrates the docs CI/CD workflows from the monolithic
elastic/docs-builderpreview-build.ymlto the new two-phase architecture inelastic/docs-actions:docs-build.yml(Phase 1) — runs onpull_request/pushwith read-only permissions for build validation, link checking, and vale lintingdocs-deploy.yml(Phase 2) — runs viaworkflow_runfrom the default branch with elevated permissions for preview deployments, PR comments, and link index updatesdocs-preview-cleanup.yml— runs onpull_request_target: [closed]to clean up deployments and S3 preview objectsRemoves the old
docs-cleanup.ymlthat calleddocs-builder'spreview-cleanup.yml.References
Post-merge
docs-buildinstead ofpreview-build(if applicable)Made with Cursor