build-docker-image-docker-cli.md

author	jess-johnson-msft
ms.author	jejohn
ms.topic	include
ms.date	06/28/2022

Step 1. At a shell prompt, confirm that Docker is accessible.

bash

docker

PowerShell terminal

docker

---

If you see the help for the Docker CLI, then continue. Otherwise, make sure Docker is installed or your shell as access to the Docker CLI.

Step 2. Build the image.

The general form of the docker build command is:

bash

 docker build --rm --pull \
  --file "<path-to-project-root>/Dockerfile" \
  --label "com.microsoft.created-by=docker-cli" \
  --tag "<container-name>:latest" \
  "<path-to-project-root>" 

PowerShell terminal

 docker build --rm --pull `
  --file "<path-to-project-root>/Dockerfile" `
  --label "com.microsoft.created-by=docker-cli" `
  --tag "<container-name>:latest" `
  "<path-to-project-root>" 

---

For example, if you are at the root of the project directory, you can use a command like this:

bash

docker build --rm --pull \
  --file "Dockerfile" \
  --label "com.microsoft.create-by=docker-cli" \
  --tag "msdocspythondjangocontainerwebapp:latest" \
  .

PowerShell terminal

docker build --rm --pull `
  --file "Dockerfile" `
  --label "com.microsoft.create-by=docker-cli" `
  --tag "msdocspythondjangocontainerwebapp:latest" `
  .

---

If you started with the Flask version of the sample app, then use "msdocspythonflaskcontainerwebapp" as the tag name. Note the dot (".") at the end of the command. You can add --no-cache to force a rebuild.

Step 3. Confirm the image was built.

Using the docker images command, you can return a list of images.

bash

docker images

PowerShell terminal

docker images

You should see images listed by REPOSITORY name, TAG, and CREATED date among other image characteristics.

---