Bug: "Unable to find Local Image"

[caleb-lyceum]

Description:

Hello, I am trying to run my docker image with SAM CLI however it is not finding my local docker image that I reference in my template.

Steps to reproduce:

Create a SAM template using a docker image and docker image URI that references a local image, sam build, sam local invoke and it is not finding my local docker image.

Observed result:

2025-01-08 10:33:33,299 | No config file found in this directory.
2025-01-08 10:33:33,301 | OSError occurred while reading TOML file: [Errno 2] No such file or directory:
'/Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/samconfig.toml'
2025-01-08 10:33:33,302 | Config file location: /Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/samconfig.toml
2025-01-08 10:33:33,302 | Config file '/Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/samconfig.toml' does not exist
2025-01-08 10:33:33,304 | Using SAM Template at /Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/.aws-sam/build/template.yaml
2025-01-08 10:33:33,317 | OSError occurred while reading TOML file: [Errno 2] No such file or directory:
'/Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/samconfig.toml'
2025-01-08 10:33:33,318 | Using config file: samconfig.toml, config environment: default
2025-01-08 10:33:33,318 | Expand command line arguments to:
2025-01-08 10:33:33,318 | --template_file=/Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/.aws-sam/build/template.yaml --no_event
--layer_cache_basedir=/Users/calebanderson/.aws-sam/layers-pkg --container_host=localhost --container_host_interface=127.0.0.1
2025-01-08 10:33:33,319 | local invoke command is called
2025-01-08 10:33:33,373 | No current session found, using default AWS::AccountId
2025-01-08 10:33:33,374 | No Parameters detected in the template
2025-01-08 10:33:33,385 | There is no customer defined id or cdk path defined for resource LambdaFunction, so we will use the resource logical id as the resource id
2025-01-08 10:33:33,386 | 0 stacks found in the template
2025-01-08 10:33:33,386 | No Parameters detected in the template
2025-01-08 10:33:33,394 | There is no customer defined id or cdk path defined for resource LambdaFunction, so we will use the resource logical id as the resource id
2025-01-08 10:33:33,394 | 1 resources found in the stack
2025-01-08 10:33:33,395 | Found Serverless function with name='LambdaFunction' and ImageUri='pdf-splitter:latest'
2025-01-08 10:33:33,395 | --base-dir is not presented, adjusting uri . relative to
/Users/calebanderson/Documents/source/lyceum/ellie-api/functions/split_pdfs/.aws-sam/build/template.yaml
2025-01-08 10:33:33,396 | Skip Building LambdaFunction function, as it is missing either Dockerfile or DockerContext metadata properties.
2025-01-08 10:33:33,402 | Found one Lambda function with name 'LambdaFunction'
2025-01-08 10:33:33,403 | Invoking Container created from pdf-splitter:latest
2025-01-08 10:33:33,403 | Loading AWS credentials from session with profile 'None'
2025-01-08 10:33:33,408 | Code None is not a zip/jar file
2025-01-08 10:33:33,414 | Local image was not found.
2025-01-08 10:33:33,415 | Removing rapid images for repo pdf-splitter
Building image.........
2025-01-08 10:33:33,633 | Failed to build Docker Image

Expected result:

I would expect that SAM is able to properly locate the docker image and build my lambda function with that.

Additional environment details (Ex: Windows, Mac, Amazon Linux etc)

1. OS: Mac OS sequoia 15.1.1 (arm64)
2. sam --version: 1.132.0
3. AWS region: us-east-1

{
  "version": "1.132.0",
  "system": {
    "python": "3.11.10",
    "os": "macOS-15.1.1-arm64-arm-64bit"
  },
  "additional_dependencies": {
    "docker_engine": "27.3.1",
    "aws_cdk": "Not available",
    "terraform": "Not available"
  },
  "available_beta_feature_env_vars": [
    "SAM_CLI_BETA_FEATURES",
    "SAM_CLI_BETA_BUILD_PERFORMANCE",
    "SAM_CLI_BETA_TERRAFORM_SUPPORT",
    "SAM_CLI_BETA_RUST_CARGO_LAMBDA"
  ]
}

[caleb-lyceum]

Output of docker images | grep pdf-splitter:

pdf-splitter                              latest                                 adbe24222e13   17 minutes ago   7.09GB

[roger-zhangg]

Thanks for reporting, could you try restarting the docker daemon. and sam build --no-cache. If the error remains, could you help to share your template.yaml? Thanks

[roger-zhangg]

Please reopen if this is still happening

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.

[huynguyen-anduin]

@roger-zhangg I got the same issue. What is the correct way to use a local image with SAM? I want to use local image in developing stage i.e. never publish to ECR yet.

I think we can use HelloWorldFunction to reproduce: https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/using-sam-cli-build.html#using-sam-cli-build-examples

1. sam build
   After this step, I found a local docker image existed:

docker images
REPOSITORY                                                        TAG                     IMAGE ID       CREATED          SIZE
helloworldfunction                                                nodejs18.x-v1           135c87a4261e   37 seconds ago   614MB

Template after build:

Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function
    Properties:
      ...
      ImageUri: helloworldfunction:nodejs18.x-v1
    Metadata:
      ...
      DockerTag: nodejs18.x-v1
      Dockerfile: Dockerfile

2. sam local invoke HelloWorldFunction

No current session found, using default AWS::AccountId
Invoking Container created from helloworldfunction:nodejs18.x-v1
Local image was not found.
Removing rapid images for repo helloworldfunction
Building image.................
Using local image: helloworldfunction:rapid-x86_64.

-> SAM does not found existed image but building another image.

[prasanthkrishnan]

the issue is still happening.

❯ docker images | grep s3
s3-to-feature-store-lambda                                                                                    latest                                                           94d878a97baf   10 minutes ago   985MB

template.yaml

Resources:
  S3ToFeatureStoreFunction:
    Type: AWS::Serverless::Function
    Properties:
      PackageType: Image
      ImageUri: s3-to-feature-store-lambda:latest
      Environment:

❯ sam local invoke S3ToFeatureStoreFunction -t template.yaml -e s3-event.json --region us-east-1 
Invoking Container created from s3-to-feature-store-lambda:latest  
Local image was not found.
Removing rapid images for repo s3-to-feature-store-lambda 
Building image..............Docker build error: The command '/bin/sh -c mv /var/rapid/aws-lambda-rie-x86_64 /var/rapid/aws-lambda-rie && chmod +x                      
/var/rapid/aws-lambda-rie' returned a non-zero code: 1                                                                                     
Docker build failed with errors: The command '/bin/sh -c mv /var/rapid/aws-lambda-rie-x86_64 /var/rapid/aws-lambda-rie && chmod +x         /var/rapid/aws-lambda-rie' returned a non-zero code: 1                                                                                     Error: Error building docker image: The command '/bin/sh -c mv /var/rapid/aws-lambda-rie-x86_64 /var/rapid/aws-lambda-rie && chmod +x /var/rapid/aws-lambda-rie' returned a non-zero code: 1