From 87cd4f408771d4018fe946fda3dbed9d0b66a9d7 Mon Sep 17 00:00:00 2001 From: Shayne Boyer Date: Mon, 18 May 2020 14:00:33 -0400 Subject: [PATCH] Docs for specifying base image:tag (#475) --- docs/reference/local_development.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/reference/local_development.md b/docs/reference/local_development.md index 5dddfa13..56239a1f 100644 --- a/docs/reference/local_development.md +++ b/docs/reference/local_development.md @@ -109,6 +109,28 @@ Tye will build all .NET projects (unless `build: false` has been specified) befo Tye will use the Docker cli to pull any needed container images before launching any services. This is done as a separate step to avoid failures when the network is very slow or an image is very large. +### Determining Docker base images and tags + +Tye will use the TFM of the project to set the base image and tags of the container images to use when creating the associated Dockerfile. + +Should you choose to use a custom base image and/or tag or variant you can do so by specifying the base image and tag in a `` in any of the projects. + +Example - custom image +```xml + + myregistry/dotnetbaseimage + v1.1.0 + +``` + +Example - Debian buster tag +```xml + + mcr.microsoft.com/dotnet/core/sdk + 3.1-buster + +``` + ## Computing bindings In order to help services communicate, Tye manages details like listening ports and hostnames. This listening information is specified to services using environment variables in development. This section will summarize some of the key information for local development, but the best guide for the topic is the [service discovery documentation](/docs/reference/service_discovery.md).