Merge pull request #313114 from ggailey777/pr-128202

[Functions] Ported custom Dockerfile templates from public repo

Author: prmerger-automator[bot]

articles/azure-functions/functions-how-to-custom-container.md

@@ -1,7 +1,7 @@
 ---
 title: Work with Azure Functions in Containers
 description: Learn how to work with containerized function apps running in Linux containers in an Azure Container Apps environment.
-ms.date: 02/25/2026
+ms.date: 03/13/2026
 ms.topic: how-to
 zone_pivot_groups: functions-container-hosting
 ms.custom:
@@ -99,6 +99,15 @@ The Azure Functions extension for Visual Studio Code creates your Dockerfile whe
 
 ---
 
+## Create a custom Dockerfile
+
+Instead of using a generated Dockerfile, you can manually create one when you need more control over your container image. The [custom-container](https://github.com/Azure/azure-functions-docker/tree/dev/custom-container) folder of the `azure-functions-docker` repository provides these templates to get you started:
+
+| Template | Description |
+|----------|-------------|
+| [template.Dockerfile](https://github.com/Azure/azure-functions-docker/blob/dev/custom-container/template.Dockerfile) | A commented, step-by-step guide for building a custom container. It includes instructions for multiple language runtimes (Java, .NET isolated, Node.js, PowerShell, Python), optional CA certificate installation, running as a non-root user, and enabling SSH for Kudu debugging. |
+| [sample.Dockerfile](https://github.com/Azure/azure-functions-docker/blob/dev/custom-container/sample.Dockerfile) | A ready-to-use example built from the template that creates a Java-based Azure Functions container with SSH enabled for Kudu debugging. |
+
 ## Create your function app in a container
 
 With a Functions-generated Dockerfile in your code project, you can use Docker to create the containerized function app on your local computer. The following `docker build` command creates an image of your containerized functions from the project in the local directory: