🐳 Docker Containers for AI and Data Science Developers Docker is a powerful tool that allows you to package your applications and their dependencies into a single container. This makes it easy to deploy and run your applications in any environment, whether it's on your local machine, in the cloud, or on a server. Docker is especially useful for AI and data science developers, as it allows you to create reproducible environments for your projects. This means that you can share your code with others and be sure that it will run the same way on their machines as it does on yours. Docker is also importat for MLOps, as it allows you to create containers for your machine learning models. This makes it easy to deploy your models in production and scale them as needed. 🐳 Docker Containers for AI and Data Science Developers 🐳 Dockerizing Your Streamlit App: Beginner Friendly Guide ✅ Step 0: Prerequisites 🐍 Install Python 📦 Install pip (comes with Python) Update pip (optional): 📦 Step 1: Set Up Your Project 🐍 Step 2: Set Up Virtual Environment (venv) 📦 Step 3: Install Streamlit & Freeze Requirements 🐳 Step 4: Create a Dockerfile 🚫 Step 5: Create a .dockerignore file 🧱 Step 6: Install Docker 6.1 Install Docker in lunux 🔨 Step 7: Build the Docker Image ▶️ Step 8: Run the Docker Container To run the container in detached mode (background): 🧠 Summary Docker-Hub 🚀 Push Your Image to Docker Hub 1. Log in to Docker Hub 1.1 Create a Docker Hub repository 2. Tag Your Image 3. Push the Image Docker Cheatsheet 🛠️ Troubleshooting Common Issues 🐳 Dockerizing Your Streamlit App: Beginner Friendly Guide This guide walks you through converting your local Streamlit app using virtual environment (venv) into a Docker container, so it can run anywhere, even without Python installed! ✅ Step 0: Prerequisites Make sure you have the following installed: 🐍 Install Python Download from: https://www.python.org/downloads/ Make sure to select "Add Python to PATH" during installation. 📦 Install pip (comes with Python) Check it: pip --version # or pip3 --version # for macOS/Linux Update pip (optional): # for windows python -m pip install --upgrade pip # for macos/linux python3 -m pip install --upgrade pip 📦 Step 1: Set Up Your Project Create your app folder: mkdir my-streamlit-app cd my-streamlit-app Add your Streamlit app code: touch app.py Paste a sample app: # app.py # write in terminal cat >> app.py import streamlit as st st.title("My First Dockerized Streamlit App with [codanics](www.codanics.com)") st.write("Hello from inside Docker!") Press CTRL+D to save and exit. You can also use any text editor to create app.py and paste the code. 🐍 Step 2: Set Up Virtual Environment (venv) python -m venv .venv Activate the environment: On macOS/Linux: source .venv/bin/activate On Windows: .venvScriptsactivate 📦 Step 3: Install Streamlit & Freeze Requirements pip install streamlit pip freeze > requirements.txt This creates a file requirements.txt. 🐳 Step 4: Create a Dockerfile Create a file called Dockerfile in your project folder: touch Dockerfile Add the following content: # Use official Python image FROM python:3.10-slim # Set working directory inside container WORKDIR /app # Copy app code to container COPY . /app # Install dependencies RUN pip install --no-cache-dir -r requirements.txt # Expose Streamlit default port EXPOSE 8501 # Run the app CMD ["streamlit", "run", "app.py", "--server.port=8501", "--server.address=0.0.0.0"] 🚫 Step 5: Create a .dockerignore file Ignore unnecessary files by creating a .dockerignore file: touch .dockerignore Add the following content: __pycache__/ *.pyc .venv/ .env 🧱 Step 6: Install Docker Download Docker Desktop from: 👉 https://www.docker.com/products/docker-desktop You need to create a Docker account to download. Follow the installation instructions for your OS (Windows, macOS, or Linux). 6.1 Install Docker in lunux # for ubuntu sudo apt-get update sudo apt-get install docker.io # after installation sudo systemctl start docker sudo systemctl enable docker # check docker version docker --version For other Linux distributions, refer to the official Docker documentation. Once installed, verify: docker --version Docker version 28.0.4, build b8034c0 If you see a version number, Docker is installed correctly. Trouble Shooting: If you see an error, restart your computer and try again. If you still see an error, check Docker Desktop is running. If you see a message about "WSL 2 backend", follow the instructions to enable it. If you see a message about "Docker Desktop is starting", wait for it to finish. If you see a message about "Docker Desktop is running", you're good to go! 🔨 Step 7: Build the Docker Image In your project folder (with Dockerfile): Run Docker Desktop. Make sure Docker Desktop is running. Open a terminal or command prompt. Navigate to your project folder. Run the following command to build the Docker image: docker build -t my-streamlit-app . -t my-streamlit-app gives your image a name. . specifies the current directory as the build context. you can also create a docker image which suits your choice of platform such as linux /arm64 or linux/amd64 or windows/amd64 or windows/arm64 or linux/arm/v7 or linux/arm/v6 etc. # check docker image docker buildx ls # for ubuntu x86_64 docker buildx build --platform linux/amd64 -t my-streamlit-app . remove images # list my docker images docker images # remove my docker image docker rmi my-streamlit-app:latest # remove my docker image by id docker rmi e518336f912b -f Do check your platform version using the following commands: ```bash # for linux uname -m # for windows wmic os get osarchitecture # for macos uname -m Note: Allow vscode to use other apps if asked. If you see a message like Sending build context to Docker daemon 3.072kB, it means Docker is building the image. This command may take a few minutes to complete, depending on your internet speed and system performance. You will see a lot of output as Docker builds the image. If you see a message like Successfully built , your image is ready! Check if image is available in Docker: docker images You should see my-streamlit-app in the list of images. ▶️ Step 8: Run the Docker Container docker run -p 8501:8501 my-streamlit-app -p 8501:8501 maps port 8501 on your host to port 8501 in the container. my-streamlit-app is the name of your image. This command runs the container in the foreground, so you can see the logs. If you see a message like Starting up server, your app is running! Visit: 👉 http://localhost:8501 🎉 Your Streamlit app is now running inside a Docker container! To run the container in detached mode (background): docker run --name MAtufail -d -p 8501:8501 my-streamlit-app -d runs the container in detached mode (in the background). --name MAtufail gives your container a name (optional). You can check running containers with: docker ps To stop the container, use: docker stop MAtufail To remove the container, use: docker rm MAtufail 🧠 Summary Task Command Create venv python -m venv .venv Activate venv source .venv/bin/activate or .venvScriptsactivate Install Streamlit pip install streamlit Save requirements pip freeze > requirements.txt Build Docker image docker build -t my-streamlit-app . Run Docker container docker run -p 8501:8501 my-streamlit-app 📬 Need help? Ask your questions at: github.com/aammartufail Docker-Hub Docker Hub is a cloud-based repository for Docker images. You can push your images to Docker Hub to share them with others or use them on different machines. To push your image to Docker Hub, you need to create an account and log in to Docker Hub from your terminal. You can then use the docker push command to upload your image. 🚀 Push Your Image to Docker Hub Let's push your image to the Docker Hub repository maammartufail/test_app. 1. Log in to Docker Hub docker login Enter your Docker Hub username and password when prompted. 1.1 Create a Docker Hub repository Go to Docker Hub. Click on Create Repository. Enter the name of your repository (e.g., test_app). Choose Public or Private. I prefer Public. Click on Create. You can also create a repository from the command line using the Docker CLI. docker create repository maammartufail/test_app This command creates a new repository named test_app under your Docker Hub account maammartufail. You can also create a repository from the Docker Hub website. 2. Tag Your Image Tag your local image (my-streamlit-app) to match your Docker Hub repo: # Check your image ID docker images # Tag your image docker tag my-streamlit-app maammartufail/test_app:latest 3. Push the Image docker push maammartufail/test_app:latest After the push completes, your image will be available at: https://hub.docker.com/r/maammartufail/test_app Tip: You can now pull and run this image from any machine with Docker installed: docker pull maammartufail/test_app:latest docker run -p 8501:8501 maammartufail/test_app:latest Run in background: # run in background even if you restart your computer docker run --name MAtufail -d -p 8501:8501 maammartufail/test_app:latest # check running containers docker ps # check logs docker logs MAtufail # stop the container docker stop MAtufail # remove the container docker rm MAtufail # remove the image docker rmi maammartufail/test_app:latest Docker Cheatsheet Docker cheatsheet for common commands is available at: 👉 Docker Cheatsheet This command downloads the image from Docker Hub and runs it locally. You can also use this image in cloud platforms like AWS, Azure, or Google Cloud. You can also use this image in CI/CD pipelines to automate your deployment process. You can also use this image in Kubernetes to deploy your app in a container orchestration platform. 🛠️ Troubleshooting Common Issues Docker Daemon Not Running: Make sure Docker Desktop is running. Permission Denied: Run Docker commands with sudo on Linux. Image Not Found: Check the image name and tag. Port Already in Use: Change the port mapping in the docker run command. Container Not Starting: Check the logs with docker logs . Streamlit Not Found: Make sure you have streamlit in your requirements.txt. Network Issues: Check your internet connection and firewall settings. Dockerfile Errors: Check the syntax and paths in your Dockerfile. Slow Build: Use --no-cache to speed up the build process. Image Size: Use docker system prune to clean up unused images and containers. Docker Desktop Issues: Restart Docker Desktop or your computer. Docker Hub Issues: Check Docker Hub status page for outages.
