AWS App Runner & ECR

ECR + AWS App Runner: Step by Step

1. Prerequisite

Make sure you have Docker Desktop installed.

Warning

The homebrew version ofdocker-compose requires virtualbox, and will not work on Apple Silicon computers.

Ensure aws-cli is installed and configured

brew install awscli
aws configure

You’ll need your account_key_id & secret_access_key from the AWS console.

Log docker client into AWS ECR with aws ecr get-login-password --region __region__ | docker login --username AWS --password-stdin __aws_account_id__.dkr.ecr.__region__.amazonaws.com

For example:

aws ecr get-login-password --region eu-west-1 | docker login --username AWS --password-stdin xxxxxxxxxxx.dkr.ecr.eu-west-1.amazonaws.com

2. Set up ECR

Create your private repository for your project in the AWS console, and note down the repository_name.

3. Build Your Application

Build the Docker image

docker build .

Tag the local Docker image with the ECR repository name & tags using: docker tag __IMAGE ID__ __aws_account_id__.dkr.ecr._region_.amazonaws.com/__repository_name__:__tag__

For example:

docker tag xxxxxxxxx xxxxxxxxx.dkr.ecr.eu-west-1.amazonaws.com/the-app-that-will-blow-your-socks-off:0.0.11

4. Push Dockerised Application to ECR Repository

Push the images to ECR using docker push __repository__:__tag__

docker push xxxxxxxxxxx.dkr.ecr.eu-west-1.amazonaws.com/the-app-that-will-blow-your-socks-off:0.0.11

Verify that the docker image is pushed to ECR from the AWS console

5. Run Application w/ App Runner

Head to the App Runner Console once the Docker image is up in ECR. Make sure you choose the same region as the ECR. You should be able to find the image from the dropdown if you have selected the same AWS region.

Following the Creating App Runner Service step-by-step guide.

Local Development with docker compose

docker compose --env-file ./.env.local up

Troubleshooting

AWS ECS/ECS exec /usr/local/bin/docker-entrypoint.sh: exec format error

If you build your docker image on an Apple M1/M2 machine, this error may occur. To fix the issue, use:

FROM --platform=linux/amd64 node:lts-alpine
 
# Insdead of the standard `FROM node:lts-alpine`

Private

-----BEGIN PGP MESSAGE-----

hQIOAxdwc3QWykEfEAgA1kHF/7oJaEbhwu3oDYCTFvLX0hrS2T/h41sqG6V1YSud
jYzawvAnLgLhuxW1zYAADVssoII5Fih/yWg4rKR3dJ25kXt4cllK3sjsOhCk4KOK
j2j5FIU9SbFJlIs68wj6rO/9OVuPiLq3OVbn8XvQ4hJMduebmk2mp/N4iEcHymKD
JMYa/FrsUAljoQ8JPb9Hh+rOgcnbfjoA80VgWbVqU5qGnWp8OG1fydZWhwQzyCF8
oDXGTS8wgh5gFg2U4LTvW5hP2UfeD1NNFj12ZTFCi9Zs5lrWTQnL3oo4gpXJ0LPr
Ce6HAYTOh//l4mgyCdrhV2FSgwLpJrl4N7Qv72kjawf/dsRAINfcsi8xeWzlBuvQ
0je6uc/JNBYdTjFVXTlfKHT4KgYqGzO0XE7BvdzMGDanbsoY1ube7XpMeFE6ptJo
08FdPJBfJL5GEAbeJgRouyl0jpV29rUb1Ye8Gslr5EUacTDGPuWc/1hjIG6M4Fo2
BX3xShsUkPMIkI0VkNCnrhKPP5qkd2kH1A3mY3NwTcCFeaf1SEGATey08LrBF5bt
VzameN/0BZJEVk6TBMX8uVm+ErQaY7XbPBbeLcuhClowd9UOrKKzYN+vUa+w5LFN
sHVqFM+JnEuhOD03OW4CdhJw1v01y8ASvlyCzYZmWEZNG87Cu/OYOuaLMJ/bCtRn
1dLA6AGR7dpBPkS5l/bBr8aqkt1/RtXBQa1x44AHk4bxXn86SS8XA0XyVGePgeWb
YU0CDMEDr0bGJSs+c14EjLv1HPVsruiQitnt3S9DngLPugs7qOpDXlKab6f/DqSw
s9+oenwlcKhjpDkzuGMAzq5xSIqZp/cvdernB2Os+3/Txw8N1mJWQpP5ya1gY2oA
WjzDkpKSq0U2+0r7YbdzGf53Rq1nvQ+Sdl2x+oAx6nXc1ggetSS9KfW1R7cYwrBh
gN2ekvIGpNvu4H/nUHPlmrw8Ahm1129v5eg38k14CG74HbW5hDm9aprwvCHNsqu/
/pwzYXMXdxMJMammRJOhGVmpSqcMzUXwYJzn0sWiEde8Mgs/sf0oWAlQk5EpD5Ry
p/Cu1zFcW27a2sI9p660EwvAPWW9s+flSaOVYlJojOgoBdLRREW0YMs6X5gNRn8v
KU1fITasm9Jei7dClpVaocc2/MUxlxXS/2+qKjB/hBi974xxWP/FCz28ktRNhw49
mhRhxWFT/q1YYLIQrwQChTrrljQE6lMPlxVoXeMFjhAaxfwlDgis55DFNBc=
=+NwU
-----END PGP MESSAGE-----