Skip to content

docs(wip): compute environment pre-flight checks reference page#1604

Closed
MichaelTansiniSeqera wants to merge 6 commits into
masterfrom
docs/preflight-checks
Closed

docs(wip): compute environment pre-flight checks reference page#1604
MichaelTansiniSeqera wants to merge 6 commits into
masterfrom
docs/preflight-checks

Conversation

@MichaelTansiniSeqera

Copy link
Copy Markdown
Contributor

Summary

  • Adds platform-cloud/docs/compute-envs/preflight-checks.mdx — a new reference page covering Platform's pre-flight check system (COMP-1724, COMP-1725, COMP-1767, COMP-1829)
  • Explains all three validation tiers: background credential sweep, background CE sweep (~1h), and synchronous launch-time checks
  • Includes a proactive guidance section so users know what to verify before creating a CE
  • Full error-message reference tables with resolution steps (exact strings from code)

Status

This is a WIP draft. Still needs:

  • Screenshots: CE INVALID banner, and ⋮ dropdown showing Validate button
  • Verify Tower Agent doc link path is correct
  • Add page to sidebar/nav config
  • Review for accuracy once COMP-1724/1725/1767/1829 are fully shipped

Jira

COMP-1724, COMP-1725, COMP-1767, COMP-1829

🤖 Generated with Claude Code

Covers all three validation tiers (credential sweep, CE background
sweep, synchronous launch checks), the manual re-validate flow, and
a full error-message reference table with resolution steps.

Also adds a proactive guidance section so users know what to verify
before creating a CE.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for seqera-docs ready!

Name Link
🔨 Latest commit 77ca42b
🔍 Latest deploy log https://app.netlify.com/projects/seqera-docs/deploys/6a3a85f9b8e4a800083e2ff8
😎 Deploy Preview https://deploy-preview-1604--seqera-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

When a compute environment is marked **INVALID** and you have fixed the underlying issue, you can trigger an immediate re-validation without waiting for the next background sweep:

1. Navigate to **Compute environments** in your workspace.
2. Find the CE and open its **⋮** (three-dot) dropdown menu.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[Seqera.Features] Use 'drop-down' instead of 'dropdown'

MichaelTansiniSeqera and others added 5 commits June 23, 2026 13:17
All supported cloud storage backends (S3, GCS, Azure Blob) are flat
object stores — sub-paths are created on first write, no pre-creation
needed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… permissions

The sweep calls GetCallerIdentity (AWS) and equivalents — this verifies
the keys are accepted, not that the credential has sufficient permissions
to run a pipeline. Removed the incorrect permissions note.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Background CE sweep skips INVALID CEs entirely — recovery requires
explicit manual Validate. Removed the "re-validated automatically" claim.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

1 participant