Skip to content

Move docs workflows to elastic/docs-actions#6689

Merged
theletterf merged 1 commit intoelastic:mainfrom
Mpdreamz:migrate/docs-actions-workflows
Mar 30, 2026
Merged

Move docs workflows to elastic/docs-actions#6689
theletterf merged 1 commit intoelastic:mainfrom
Mpdreamz:migrate/docs-actions-workflows

Conversation

@Mpdreamz
Copy link
Copy Markdown
Member

Summary

Moves our docs CI/CD workflow logic from elastic/docs-builder to
elastic/docs-actions.
elastic/docs-builder has grown in scope; elastic/docs-actions lets the
docs team push updates to the @v1 tag independently without coupling to
the broader builder tooling.

The new setup follows GitHub's recommended two-phase workflow approach:
all required checks on pull requests now run with read-only access only.
Preview deployments and PR comments happen in a separate phase triggered
after the required check completes.

Replaces preview-build.yml and docs-cleanup.yml with three new workflow
files: docs-build.yml, docs-deploy.yml, and docs-preview-cleanup.yml.

Preview deployments for forks:
Preview deployments are not available for fork PRs by default. If you are an
Elastic employee working from a fork, previews will work once your Elastic
GitHub organization membership is set to Public:

  1. Go to https://github.com/orgs/elastic/people and find your name

  2. Open the visibility dropdown next to your name and select Public

    Or: GitHub profile -> Organizations -> Elastic logo -> set visibility
    to Public.

Contributors outside Elastic will still get build validation feedback on
their PRs -- only preview deployments are skipped.

Post-merge

  • Update branch protection rules to require docs-build instead of
    preview-build (if applicable)

cc @elastic/ingest-docs

Moves docs CI/CD from elastic/docs-builder to elastic/docs-actions.
Part of elastic/docs-eng-team#474
@Mpdreamz Mpdreamz requested a review from a team as a code owner March 30, 2026 11:17
@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Mar 30, 2026

This pull request does not have a backport label. Could you fix it @Mpdreamz? 🙏
To fixup this pull request, you need to add the backport labels for the needed
branches, such as:

  • backport-./d./d is the label to automatically backport to the 8./d branch. /d is the digit
  • backport-active-all is the label that automatically backports to all active branches.
  • backport-active-8 is the label that automatically backports to all active minor branches for the 8 major.
  • backport-active-9 is the label that automatically backports to all active minor branches for the 9 major.

@theletterf theletterf merged commit 9fd5db3 into elastic:main Mar 30, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants