Skip to content

EDU-159 Add AWS ECR Public Registry authentication documentation#1066

Open
seqera wants to merge 2 commits into
masterfrom
claude/EDU-159/public-ecr-wave-docs
Open

EDU-159 Add AWS ECR Public Registry authentication documentation#1066
seqera wants to merge 2 commits into
masterfrom
claude/EDU-159/public-ecr-wave-docs

Conversation

@seqera

@seqera seqera commented Jun 25, 2026

Copy link
Copy Markdown

Summary

Adds a dedicated Registry-specific notes section to the authentication feature page covering:

  • AWS ECR Private Registry — brief summary with IAM policy (AmazonEC2ContainerRegistryReadOnly) and link to Platform credentials docs.
  • AWS ECR Public Registry — detailed new documentation including:
    • How ECR Public (public.ecr.aws) differs from private ECR (hostname, auth endpoint, rate limiting)
    • Required IAM permissions, with a callout that sts:GetServiceBearerToken must be granted separately from AmazonElasticContainerRegistryPublicReadOnly
    • Step-by-step Seqera Platform credentials setup using public.ecr.aws as the registry server
    • Self-hosted Wave YAML config example for wave.registries."public.ecr.aws"
    • Note that ECR Public auth always targets us-east-1 regardless of deployment region

Motivation

Users hitting the support queue (ticket 5013) did not know that:

  1. ECR Public needs explicit credentials with public.ecr.aws as the registry server
  2. sts:GetServiceBearerToken is required but absent from the AmazonElasticContainerRegistryPublicReadOnly managed policy
  3. The auth endpoint is always us-east-1

The previous docs mentioned "AWS ECR (private and public)" in passing with no actionable guidance for ECR Public.

Key: EDU-159

Co-authored by Claude agent for Jira.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This PR expands the Wave authentication documentation by adding a registry-specific section, with new guidance for configuring and using AWS ECR Public registry authentication in Seqera Platform and self-hosted Wave deployments.

Changes:

  • Added a new “Registry-specific notes” section to the authentication feature docs.
  • Documented AWS ECR Public specifics (hostnames, auth endpoint region behavior, IAM permissions, and rate limiting context).
  • Added step-by-step Seqera Platform credential setup guidance and a self-hosted Wave YAML configuration example for public.ecr.aws.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/features/authentication.mdx Outdated
Comment on lines +96 to +106
The IAM user needs the following permissions to authenticate to ECR Public:

- `ecr-public:GetAuthorizationToken`
- `ecr-public:BatchCheckLayerAvailability`
- `ecr-public:GetRepositoryPolicy`
- `ecr-public:DescribeRepositories`
- `ecr-public:DescribeImages`
- `ecr-public:DescribeImageTags`
- `sts:GetServiceBearerToken` — required for ECR Public token exchange

Attach the AWS managed policy `AmazonElasticContainerRegistryPublicReadOnly` and the `sts:GetServiceBearerToken` permission explicitly, or create a custom policy that includes all of the above.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.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.

3 participants