add LambdaBaseImage and minimal doc

Author: jtroe

.github/workflows/DockerBuild.LambdaBaseImage.yaml

@@ -0,0 +1,49 @@
+name: DockerBuild.LambdaImage
+
+on:
+  # allow it to be run on-demand
+  workflow_dispatch:
+
+jobs:
+  build-and-push:
+    name: Build Docker image and push to ghcr.io
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v2
+
+      - name: Login to Github Packages
+        uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v4
+        with:
+          images: |
+            ghcr.io/esri/arcgis-python-api-lambda
+          tags: |
+            type=raw,value=2.1.0,enable={{is_default_branch}}
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=schedule,pattern={{date 'YY.MM'}},enable={{is_default_branch}}
+            type=sha,format=long
+
+      - id: docker_build
+        name: Build image and push to GitHub Container Registry
+        uses: docker/build-push-action@v4
+        with:
+          # relative path to the place where source code with Dockerfile is located
+          context: .
+          file: ./docker/LambdaBaseImage.Dockerfile
+          tags: ${{ steps.meta.outputs.tags }}
+          provenance: false
+          platforms: linux/amd64
+          push: true

docker/LambdaBaseImage.Dockerfile

@@ -0,0 +1,21 @@
+ARG PYTHON_VERSION=3.9
+# lambda python image, defaults to python 3.9
+FROM public.ecr.aws/lambda/python:${PYTHON_VERSION}
+
+# set metadata
+LABEL org.opencontainers.image.authors="[email protected]"
+LABEL org.opencontainers.image.description="AWS Lambda image with arcgis Python API and its Linux dependencies preinstalled"
+LABEL org.opencontainers.image.licenses=Apache
+LABEL org.opencontainers.image.source=https://github.com/esri/arcgis-python-api
+
+# install dependencies, then clean yum cache
+RUN yum -y install gcc krb5-devel krb5-server krb5-libs && yum clean all && rm -rf /var/cache/yum
+# install arcgis
+ARG ARCGIS_PYTHON_VERSION=2.1.0
+RUN  pip3 install arcgis==${ARCGIS_PYTHON_VERSION} --target "${LAMBDA_TASK_ROOT}"
+# set entrypoint to app.py handler method
+# (note that app.py is missing from this base image)
+CMD [ "app.handler" ]
+# to use this base image, use FROM to specify its url
+# and `COPY app.py ${LAMBDA_TASK_ROOT}`
+# (copy your code into the lambda task root)

docker/README.md

@@ -0,0 +1,26 @@
+# docker
+
+Some useful docker images for utilizing the ArcGIS API for Python in your workflows
+
+## LambdaBaseImage
+
+#### ghcr.io/esri/arcgis-python-api-lambda:latest
+
+To use this image, setup your dockerfile like:
+```
+FROM ghcr.io/esri/arcgis-python-api-lambda
+COPY app.py ${LAMBDA_TASK_ROOT}
+```
+
+your app.py should have a handler method:
+```
+import arcgis
+
+def handler(event, context):
+    """
+    AWS Lambda Handler
+    """
+    print(f"Hello from AWS Lambda using ArcGIS API for Python {arcgis.__version__}!")
+```
+
+Push to your _private_ AWS ECR instance, and configure lambda to run from this container image.  As of this writing, public AWS ECR instances are not supported for lambda.