docs: update README

Author: skunxicat

README.md

@@ -1,20 +1,21 @@
 # terraform-aws-lambda-function
 
-> Minimal Lambda function with zip packaging for provided.al2023 runtime
+> Minimal Lambda function with zip packaging and container image support for provided.al2023 runtime
 
-Terraform module that creates a Lambda function with zip packaging, IAM execution role, and CloudWatch logs. Perfect for shell scripts and custom runtimes without container overhead.
+Terraform module that creates a Lambda function with zip packaging or container images, IAM execution role, and CloudWatch logs. Perfect for shell scripts and custom runtimes.
 
 ## Features
 
 - **Zip packaging** from source directory
+- **Container image** deployment from ECR
 - **IAM execution role** with basic Lambda permissions
 - **CloudWatch log group** with configurable retention
 - **provided.al2023 runtime** optimized for shell scripts
 - **CloudPosse labeling** for consistent naming
 
 ## Usage
 
-### Basic Usage with Template Generation
+### Basic Usage with Zip Packaging
 
 ```hcl
 module "lambda" {
@@ -31,17 +32,42 @@ module "lambda" {
 
 This will automatically create `bootstrap`, `handler.sh`, and `Makefile` in your `../app/src` directory.
 
-**Note:** This module integrates seamlessly with any existing Terraform setup. The example above shows integration with CloudPosse labeling, but you can use it standalone or with any naming convention.
+### Container Image Usage
 
-## Advanced Usage
+```hcl
+module "lambda_function" {
+  source = "git::https://github.com/ql4b/terraform-aws-lambda-function.git"
+  
+  package_type = "Image"
+  image_uri    = "${aws_ecr_repository.example.repository_url}:latest"
+  
+  image_config = {
+    entry_point = ["/lambda-entrypoint.sh"]
+    command     = ["app.handler"]
+  }
+  
+  memory_size = 512
+  timeout     = 30
+  
+  environment_variables = {
+    THUMBNAILS_BUCKET = module.thumbnails_bucket.bucket_id
+  }
+  
+  context    = module.label.context
+  attributes = ["lambda"]
+}
+```
+
+**Note:** This module integrates seamlessly with any existing Terraform setup. The examples above show integration with CloudPosse labeling, but you can use it standalone or with any naming convention.
+
+## Advanced Zip Configuration
 
 ```hcl
 module "lambda_function" {
   source = "git::https://github.com/ql4b/terraform-aws-lambda-function.git"
   
-  source_dir         = "./src"
-  create_templates   = true
-  template_dir       = "./src"
+  package_type = "Zip"
+  source_dir   = "./src"
   
   handler            = "bootstrap"
   runtime            = "provided.al2023"
@@ -64,25 +90,34 @@ module "lambda_function" {
 }
 ```
 
-## Integration with Existing Projects
+## Variables
+
+| Name | Description | Type | Default | Required |
+|------|-------------|------|---------|:--------:|
+| package_type | Lambda deployment package type | `string` | `"Zip"` | no |
+| image_uri | ECR image URI for container image deployment | `string` | `null` | no |
+| image_config | Container image configuration | `object` | `null` | no |
+| source_dir | Path to source directory (Zip only) | `string` | n/a | yes |
+| handler | Lambda function handler (Zip only) | `string` | `"bootstrap"` | no |
+| runtime | Lambda runtime (Zip only) | `string` | `"provided.al2023"` | no |
+| architecture | Lambda function architecture | `string` | `"arm64"` | no |
+| memory_size | Memory in MB | `number` | `128` | no |
+| timeout | Timeout in seconds | `number` | `3` | no |
+| environment_variables | Environment variables | `map(string)` | `{}` | no |
 
-This module is designed to plug into any existing Terraform setup:
+## Container Image Configuration
+
+The `image_config` object supports:
 
 ```hcl
-# Add to your existing main.tf
-module "my_function" {
-  source = "git::https://github.com/ql4b/terraform-aws-lambda-function.git"
-  
-  source_dir       = "./lambda-src"
-  create_templates = true
-  template_dir     = "./lambda-src"
-  
-  # Use your existing naming/tagging strategy
-  context = var.context  # or however you handle naming
+image_config = {
+  entry_point       = ["/lambda-entrypoint.sh"]  # Optional
+  command          = ["app.handler"]              # Optional  
+  working_directory = "/var/task"                 # Optional
 }
 ```
 
-## Template Generation
+## Template Generation (Zip Only)
 
 Set `create_templates = true` to automatically generate starter files:
 
@@ -157,7 +192,7 @@ export FUNCTION_NAME=$(terraform output -raw function_name)
 export FUNCTION_NAME=$(tf output --json lambda | jq -r .function_name)
 ```
 
-### 3. Use the Generated Makefile
+### 3. Use the Generated Makefile (Zip Only)
 
 When `create_templates = true`, a `Makefile` is generated with deployment workflows:
 
@@ -203,15 +238,15 @@ cat /tmp/response.json
 
 - Terraform >= 1.0
 - AWS provider >= 5.0
-- Archive provider >= 2.0
+- Archive provider >= 2.0 (Zip packaging only)
 
 ## Outputs
 
 - `function_name` - Lambda function name
 - `function_arn` - Lambda function ARN
 - `execution_role_arn` - IAM execution role ARN
+- `execution_role_name` - IAM execution role name
 - `log_group_name` - CloudWatch log group name
-- `template_files` - Paths to generated template files (when `create_templates = true`)
 
 ## Integration with Lambda Layers