Skip to content

Pulling the Docker Image

Welcome to the Docker pull guide! Let's get the arcade software onto your computer so we can deploy it to AWS. 🐳

Before You Start 📋

Make sure you have:

  • Docker Desktop installed and running
  • Terminal or PowerShell open
  • AWS account set up

Not Ready?

Need to install Docker? Check our Prerequisites Guide first!

Understanding Docker Images 🤔

Before we pull the image, let's understand what we're doing:

What's a Docker Image?

Think of a Docker image like a video game installer:

  • It contains all the software we need
  • It's pre-configured and ready to run
  • It works the same way on every computer
  • You can share it easily with others

Getting and Renaming the Image ⬇

  1. First, pull the image:
docker pull yeeyon/arcade-stem:latest
  1. Give it a more descriptive name:
docker tag yeeyon/arcade-stem:latest diy-artcade-payment-api:latest
  1. Remove the old name (optional):
docker rmi yeeyon/arcade-stem:latest
  1. Verify everything worked:
docker images

You should see something like:

REPOSITORY                 TAG       IMAGE ID       CREATED        SIZE
diy-artcade-payment-api   latest    abc123def456   1 minute ago   156MB

About Image Names

  • Renaming an image with docker tag doesn't create a copy
  • It just gives the same image a new name
  • This helps us keep our project organized
  • Both names would work the same way in commands

Testing the Image 🧪

Let's make sure the image works:

docker run --platform linux/amd64 --rm diy-artcade-payment-api:latest echo "Hello from arcade container"

docker run --rm diy-artcade-payment-api:latest echo "Hello from arcade container"

You should see: 

Hello from arcade container

What Did We Do?

  • docker run starts a container
  • --rm removes it when finished
  • echo "Hello..." tests that it works
  • --platform linux/amd64 ensures compatibility with Apple Silicon Macs
  • If you see the message, your image is working!

Checking Image Details 🔍

View detailed information about your image:

docker inspect diy-artcade-payment-api:latest

This shows you:

  • When it was created
  • What operating system it uses
  • What settings it has
  • And lots more!

Next Steps: Setting Up Lambda 🚀

Now that you have the Docker image on your computer, it's time to:

  1. Push it to Amazon ECR
  2. Set up AWS Lambda to use your image
  3. Configure your cloud API

The next guide will walk you through these steps!

Continue to Lambda Setup → Back to Quick Deploy Overview

Troubleshooting 🔧

Common Issues

Docker Not Running 

Cannot connect to the Docker daemon

  • Make sure Docker Desktop is running
  • Try restarting Docker Desktop

Disk Space Issues 

no space left on device

  • Clear old Docker images: docker system prune
  • Free up disk space

Slow Download

  • Check your internet connection
  • Try again later
  • Ask if there's a local copy available

Need Help?

Understanding the Process 💡

Here's what's happening when you pull and push Docker images:

graph LR
    A[Docker Hub] -->|Pull| B[Your Computer]
    B -->|Push| C[Amazon ECR]
    C -->|Deploy| D[AWS Lambda]

Keep Terminal Open

After successfully pulling the image, keep your terminal open - you'll need it for the next step when pushing to ECR!

Remember, pulling the Docker image is just the first step. Next, we'll get it into AWS where it can power your arcade cabinet's payment system!