Completing Setup, Running the Application, and Summary

**/.DS_Store **/__pycache__ **/.venv **/.classpath **/.dockerignore **/.env **/.git **/.gitignore **/.project **/.settings **/.toolstarget **/.vs **/.vscode **/*.*proj.user **/*.dbmdl **/*.jfm **/bin **/charts **/docker-compose* **/compose.y*ml **/Dockerfile* **/node_modules **/npm-debug.log **/obj **/secrets.dev.yaml **/values.dev.yaml LICENSE README.md ``` Create a file named `.gitignore` with the following contents. ```text {collapse=true,title=".gitignore"} # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # C extensions *.so # Distribution / packaging .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib/ lib64/ parts/ sdist/ var/ wheels/ share/python-wheels/ *.egg-info/ .installed.cfg *.egg MANIFEST # Unit test / coverage reports htmlcov/ .tox/ .nox/ .coverage .coverage.* .cache nosetests.xml coverage.xml *.cover *.py,cover .hypothesis/ .pytest_cache/ cover/ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm __pypackages__/ # Environments .env .venv env/ venv/ ENV/ env.bak/ venv.bak/ ``` {{< /tab >}} {{< /tabs >}} You should now have the following contents in your `python-docker-example` directory. ```text ├── python-docker-example/ │ ├── app.py │ ├── requirements.txt │ ├── .dockerignore │ ├── .gitignore │ ├── compose.yaml │ ├── Dockerfile │ └── README.md ``` To learn more about the files, see the following: - [Dockerfile](/reference/dockerfile.md) - [.dockerignore](/reference/dockerfile.md#dockerignore-file) - [.gitignore](https://git-scm.com/docs/gitignore) - [compose.yaml](/reference/compose-file/_index.md) ## Run the application Inside the `python-docker-example` directory, run the following command in a terminal. ```console $ docker compose up --build ``` Open a browser and view the application at [http://localhost:8000](http://localhost:8000). You should see a simple FastAPI application. In the terminal, press `ctrl`+`c` to stop the application. ### Run the application in the background You can run the application detached from the terminal by adding the `-d` option. Inside the `python-docker-example` directory, run the following command in a terminal. ```console $ docker compose up --build -d ``` Open a browser and view the application at [http://localhost:8000](http://localhost:8000). To see the OpenAPI docs you can go to [http://localhost:8000/docs](http://localhost:8000/docs). You should see a simple FastAPI application. In the terminal, run the following command to stop the application. ```console $ docker compose down ``` For more information about Compose commands, see the [Compose CLI reference](/reference/cli/docker/compose/_index.md). ## Summary In this section, you learned how you can containerize and run your Python application using Docker. Related information: - [Docker Compose overview](/manuals/compose/_index.md) ## Next steps In the next section, you'll take a look at how to set up a CI pipeline using GitHub Actions.

This section details the final `.gitignore` file content and confirms the directory structure including `app.py`, `requirements.txt`, `.dockerignore`, `.gitignore`, `compose.yaml`, `Dockerfile`, and `README.md`. It guides the user through running the application using `docker compose up --build`, accessing it in a browser, and stopping it with `ctrl+c`. It also shows how to run the application in the background using `docker compose up --build -d`, access the OpenAPI docs, and stop it with `docker compose down`. The section concludes with a summary of containerizing and running a Python application with Docker and a pointer to setting up a CI pipeline using GitHub Actions in the next section.