ContextQMD
Back to Aws Doc Sdk Examples

Amazon ECR code examples for the SDK for Python

python/example_code/ecr/README.md

latest4.0 KB
Original Source

Amazon ECR code examples for the SDK for Python

Overview

Shows how to use the AWS SDK for Python (Boto3) to work with Amazon Elastic Container Registry (Amazon ECR).

<!--custom.overview.start--> <!--custom.overview.end-->

Amazon ECR is a fully managed Docker container registry that makes it easy for developers to store, manage, and deploy Docker container images.

⚠ Important

  • Running this code might result in charges to your AWS account. For more details, see AWS Pricing and Free Tier.
  • Running the tests might result in charges to your AWS account.
  • We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
  • This code is not tested in every AWS Region. For more information, see AWS Regional Services.
<!--custom.important.start--> <!--custom.important.end-->

Code examples

Prerequisites

For prerequisites, see the README in the python folder.

Install the packages required by these examples by running the following in a virtual environment:

python -m pip install -r requirements.txt
<!--custom.prerequisites.start--> <!--custom.prerequisites.end-->

Get started

Basics

Code examples that show you how to perform the essential operations within a service.

Single actions

Code excerpts that show you how to call individual service functions.

<!--custom.examples.start--> <!--custom.examples.end-->

Run the examples

Instructions

<!--custom.instructions.start--> <!--custom.instructions.end-->

Hello Amazon ECR

This example shows you how to get started using Amazon ECR.

python hello/hello_ecr.py

Learn the basics

This example shows you how to do the following:

  • Create an Amazon ECR repository.
  • Set repository policies.
  • Retrieve repository URIs.
  • Get Amazon ECR authorization tokens.
  • Set lifecycle policies for Amazon ECR repositories.
  • Push a Docker image to an Amazon ECR repository.
  • Verify the existence of an image in an Amazon ECR repository.
  • List Amazon ECR repositories for your account and get details about them.
  • Delete Amazon ECR repositories.
<!--custom.basic_prereqs.ecr_Scenario_RepositoryManagement.start--> <!--custom.basic_prereqs.ecr_Scenario_RepositoryManagement.end-->

Start the example by running the following at a command prompt:

python ecr_getting_started.py
<!--custom.basics.ecr_Scenario_RepositoryManagement.start--> <!--custom.basics.ecr_Scenario_RepositoryManagement.end-->

Tests

⚠ Running tests might result in charges to your AWS account.

To find instructions for running these tests, see the README in the python folder.

<!--custom.tests.start--> <!--custom.tests.end-->

Additional resources

<!--custom.resources.start--> <!--custom.resources.end-->

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0