use gh_workflow::{ Event, Expression, Input, Job, Level, Permissions, Push, Run, Step, Use, UsesJob, Workflow, WorkflowCall, WorkflowCallSecret, WorkflowDispatch, }; use crate::tasks::workflows::{ runners, steps::{ self, CommonJobConditions, CommonPermissionSets, FluentBuilder as _, NamedJob, UploadArtifactStep, named, release_job, }, vars::{self, StepOutput, WorkflowInput}, }; const BUILD_OUTPUT_DIR: &str = "target/deploy"; pub(crate) enum DocsChannel { Nightly, Preview, Stable, } impl DocsChannel { pub(crate) fn site_url(&self) -> &'static str { match self { Self::Nightly => "/docs/nightly/", Self::Preview => "/docs/preview/", Self::Stable => "/docs/", } } pub(crate) fn project_name(&self) -> &'static str { match self { Self::Nightly => "docs-nightly", Self::Preview => "docs-preview", Self::Stable => "docs", } } pub(crate) fn channel_name(&self) -> &'static str { match self { Self::Nightly => "nightly", Self::Preview => "preview", Self::Stable => "stable", } } } pub(crate) fn lychee_link_check(dir: &str) -> Step { named::uses( "lycheeverse", "lychee-action", "82202e5e9c2f4ef1a55a3d02563e1cb6041e5332", ) // v2.4.1 .add_with(("args", format!("--no-progress --exclude '^http' '{dir}'"))) .add_with(("fail", true)) .add_with(("jobSummary", false)) } pub(crate) fn install_mdbook() -> Step { named::uses( "peaceiris", "actions-mdbook", "ee69d230fe19748b7abf22df32acaa93833fad08", // v2 ) .with(("mdbook-version", "0.4.37")) } pub(crate) fn build_docs_book(docs_channel: String, site_url: String) -> Step { named::bash(indoc::formatdoc! {r#" mkdir -p {BUILD_OUTPUT_DIR} mdbook build ./docs --dest-dir=../{BUILD_OUTPUT_DIR}/docs/ "#}) .add_env(("DOCS_CHANNEL", docs_channel)) .add_env(("MDBOOK_BOOK__SITE_URL", site_url)) } fn docs_build_steps( job: Job, checkout_ref: Option, docs_channel: impl Into, site_url: impl Into, ) -> Job { let docs_channel = docs_channel.into(); let site_url = site_url.into(); steps::use_clang( job.add_env(("DOCS_AMPLITUDE_API_KEY", vars::DOCS_AMPLITUDE_API_KEY)) .add_env(("DOCS_CONSENT_IO_INSTANCE", vars::DOCS_CONSENT_IO_INSTANCE)) .add_step( steps::checkout_repo().when_some(checkout_ref, |step, checkout_ref| { step.with_ref(checkout_ref) }), ) .runs_on(runners::LINUX_XL) .add_step(steps::setup_cargo_config(runners::Platform::Linux)) .add_step(steps::cache_rust_dependencies_namespace()) .map(steps::install_linux_dependencies) .add_step(steps::script("./script/generate-action-metadata")) .add_step(lychee_link_check("./docs/src/**/*")) .add_step(install_mdbook()) .add_step(build_docs_book(docs_channel, site_url)) .add_step(lychee_link_check(&format!("{BUILD_OUTPUT_DIR}/docs"))), ) } fn docs_deploy_steps(job: Job, project_name: &StepOutput) -> Job { fn deploy_to_cf_pages(project_name: &StepOutput) -> Step { named::uses( "cloudflare", "wrangler-action", "da0e0dfe58b7a431659754fdf3f186c529afbe65", ) // v3 .add_with(("apiToken", vars::CLOUDFLARE_API_TOKEN)) .add_with(("accountId", vars::CLOUDFLARE_ACCOUNT_ID)) .add_with(( "command", format!( "pages deploy {BUILD_OUTPUT_DIR} --project-name=${{{{ {} }}}} --branch main", project_name.expr() ), )) } fn upload_install_script() -> Step { named::uses( "cloudflare", "wrangler-action", "da0e0dfe58b7a431659754fdf3f186c529afbe65", ) // v3 .add_with(("apiToken", vars::CLOUDFLARE_API_TOKEN)) .add_with(("accountId", vars::CLOUDFLARE_ACCOUNT_ID)) .add_with(( "command", "r2 object put -f script/install.sh zed-open-source-website-assets/install.sh", )) } fn deploy_docs_worker() -> Step { named::uses( "cloudflare", "wrangler-action", "da0e0dfe58b7a431659754fdf3f186c529afbe65", ) // v3 .add_with(("apiToken", vars::CLOUDFLARE_API_TOKEN)) .add_with(("accountId", vars::CLOUDFLARE_ACCOUNT_ID)) .add_with(("command", "deploy .cloudflare/docs-proxy/src/worker.js")) } fn upload_wrangler_logs() -> UploadArtifactStep { steps::upload_artifact("wrangler_logs", "/home/runner/.config/.wrangler/logs/") .if_condition(Expression::new("always()")) } job.add_step(deploy_to_cf_pages(project_name)) .add_step(upload_install_script()) .add_step(deploy_docs_worker()) .add_step(upload_wrangler_logs()) } pub(crate) fn check_docs() -> NamedJob { NamedJob { name: "check_docs".to_owned(), job: docs_build_steps( release_job(&[]).add_step(steps::harden_runner()), None, DocsChannel::Stable.channel_name(), DocsChannel::Stable.site_url(), ), } } fn resolve_channel_step( channel_expr: impl Into, ) -> (Step, StepOutput, StepOutput, StepOutput) { let step = Step::new("deploy_docs::resolve_channel_step").run(format!( indoc::indoc! {r#" if [ -z "$CHANNEL" ]; then if [ "$GITHUB_REF" = "refs/heads/main" ]; then CHANNEL="nightly" else echo "::error::channel input is required when ref is not main." exit 1 fi fi case "$CHANNEL" in "nightly") SITE_URL="{nightly_site_url}" PROJECT_NAME="{nightly_project_name}" ;; "preview") SITE_URL="{preview_site_url}" PROJECT_NAME="{preview_project_name}" ;; "stable") SITE_URL="{stable_site_url}" PROJECT_NAME="{stable_project_name}" ;; *) echo "::error::Invalid docs channel '$CHANNEL'. Expected one of: nightly, preview, stable." exit 1 ;; esac {{ echo "channel=$CHANNEL" echo "site_url=$SITE_URL" echo "project_name=$PROJECT_NAME" }} >> "$GITHUB_OUTPUT" "#}, nightly_site_url = DocsChannel::Nightly.site_url(), preview_site_url = DocsChannel::Preview.site_url(), stable_site_url = DocsChannel::Stable.site_url(), nightly_project_name = DocsChannel::Nightly.project_name(), preview_project_name = DocsChannel::Preview.project_name(), stable_project_name = DocsChannel::Stable.project_name(), )) .id("resolve-channel") .add_env(("CHANNEL", channel_expr.into())); let channel = StepOutput::new(&step, "channel"); let site_url = StepOutput::new(&step, "site_url"); let project_name = StepOutput::new(&step, "project_name"); (step, channel, site_url, project_name) } fn docs_job(channel_expr: impl Into, checkout_ref: Option) -> NamedJob { let (resolve_step, channel, site_url, project_name) = resolve_channel_step(channel_expr); NamedJob { name: "deploy_docs".to_owned(), job: docs_deploy_steps( docs_build_steps( release_job(&[]) .cond(Expression::new( "github.repository_owner == 'zed-industries'", )) .name("Build and Deploy Docs") .add_step(resolve_step), checkout_ref, channel.to_string(), site_url.to_string(), ), &project_name, ), } } pub(crate) fn deploy_docs_workflow_call( channel: impl Into, checkout_ref: impl Into, ) -> NamedJob { let job = Job::default() .with_repository_owner_guard() .permissions(Permissions::default().contents(Level::Read)) .uses( "zed-industries", "zed", ".github/workflows/deploy_docs.yml", // Pinned to a commit rather than the mutable `main` ref (supply-chain hardening). // Same-repo reusable workflow; bump via Dependabot or alongside deploy_docs.yml changes. "3f16f7b9082f8828e4d6ae207d2349b1ef932517", ) .with( Input::default() .add("channel", channel.into()) .add("checkout_ref", checkout_ref.into()), ) .secrets(indexmap::IndexMap::from([ ( "DOCS_AMPLITUDE_API_KEY".to_owned(), vars::DOCS_AMPLITUDE_API_KEY.to_owned(), ), ( "DOCS_CONSENT_IO_INSTANCE".to_owned(), vars::DOCS_CONSENT_IO_INSTANCE.to_owned(), ), ( "CLOUDFLARE_API_TOKEN".to_owned(), vars::CLOUDFLARE_API_TOKEN.to_owned(), ), ( "CLOUDFLARE_ACCOUNT_ID".to_owned(), vars::CLOUDFLARE_ACCOUNT_ID.to_owned(), ), ])); NamedJob { name: "deploy_docs".to_owned(), job, } } pub(crate) fn deploy_docs_job( channel_input: &WorkflowInput, checkout_ref_input: &WorkflowInput, ) -> NamedJob { docs_job( channel_input.to_string(), Some(format!( "${{{{ {} != '' && {} || github.sha }}}}", checkout_ref_input.expr(), checkout_ref_input.expr() )), ) } pub(crate) fn deploy_docs() -> Workflow { let channel = WorkflowInput::string("channel", Some(String::new())) .description("Docs channel to deploy: nightly, preview, or stable"); let checkout_ref = WorkflowInput::string("checkout_ref", Some(String::new())) .description("Git ref to checkout and deploy. Defaults to event SHA when omitted."); let deploy_docs = deploy_docs_job(&channel, &checkout_ref); named::workflow() .with_minimal_permissions() .add_event( Event::default().workflow_dispatch( WorkflowDispatch::default() .add_input(channel.name, channel.input()) .add_input(checkout_ref.name, checkout_ref.input()), ), ) .add_event( Event::default().workflow_call( WorkflowCall::default() .add_input(channel.name, channel.call_input()) .add_input(checkout_ref.name, checkout_ref.call_input()) .secrets([ ( "DOCS_AMPLITUDE_API_KEY".to_owned(), WorkflowCallSecret { description: "DOCS_AMPLITUDE_API_KEY".to_owned(), required: true, }, ), ( "DOCS_CONSENT_IO_INSTANCE".to_owned(), WorkflowCallSecret { description: "DOCS_CONSENT_IO_INSTANCE".to_owned(), required: true, }, ), ( "CLOUDFLARE_API_TOKEN".to_owned(), WorkflowCallSecret { description: "CLOUDFLARE_API_TOKEN".to_owned(), required: true, }, ), ( "CLOUDFLARE_ACCOUNT_ID".to_owned(), WorkflowCallSecret { description: "CLOUDFLARE_ACCOUNT_ID".to_owned(), required: true, }, ), ]), ), ) .add_job(deploy_docs.name, deploy_docs.job) } pub(crate) fn deploy_nightly_docs() -> Workflow { let deploy_docs = deploy_docs_workflow_call("nightly", "${{ github.sha }}"); named::workflow() .name("deploy_nightly_docs") .permissions(Permissions::default()) .add_event(Event::default().push(Push::default().add_branch("main"))) .add_job(deploy_docs.name, deploy_docs.job) }