|
| 1 | +# README for AutoGen Docker Samples |
| 2 | + |
| 3 | +Welcome to the `autogen/samples/dockers` directory! Here you'll find Dockerfiles that are essential for setting up your AutoGen development environment. Each Dockerfile is tailored for different use cases and requirements. Below is a brief overview of each and how you can utilize them effectively. |
| 4 | + |
| 5 | +## Dockerfile Descriptions |
| 6 | + |
| 7 | +### Dockerfile.base |
| 8 | + |
| 9 | +- **Purpose**: This Dockerfile is designed for basic setups. It includes common Python libraries and essential dependencies required for general usage of AutoGen. |
| 10 | +- **Usage**: Ideal for those just starting with AutoGen or for general-purpose applications. |
| 11 | +- **Building the Image**: Run `docker build -f Dockerfile.base -t autogen_base_img .` in this directory. |
| 12 | + |
| 13 | +### Dockerfile.full |
| 14 | + |
| 15 | +- **Purpose**: This Dockerfile is for advanced features. It includes additional dependencies and is configured for more complex or feature-rich AutoGen applications. |
| 16 | +- **Usage**: Suited for advanced users who need the full range of AutoGen's capabilities. |
| 17 | +- **Building the Image**: Execute `docker build -f Dockerfile.full -t autogen_full_img .`. |
| 18 | + |
| 19 | +### Dockerfile.dev |
| 20 | + |
| 21 | +- **Purpose**: Tailored for AutoGen project developers, this Dockerfile includes tools and configurations aiding in development and contribution. |
| 22 | +- **Usage**: Recommended for developers who are contributing to the AutoGen project. |
| 23 | +- **Building the Image**: Run `docker build -f Dockerfile.dev -t autogen_dev_img .`. |
| 24 | +- **Before using**: We highly encourage all potential contributors to read the [AutoGen Contributing](https://microsoft.github.io/autogen/docs/Contribute) page prior to submitting any pull requests. |
| 25 | + |
| 26 | +## Customizing Dockerfiles |
| 27 | + |
| 28 | +Feel free to modify these Dockerfiles for your specific project needs. Here are some common customizations: |
| 29 | + |
| 30 | +- **Adding New Dependencies**: If your project requires additional Python packages, you can add them using the `RUN pip install` command. |
| 31 | +- **Changing the Base Image**: You may change the base image (e.g., from a Python image to an Ubuntu image) to suit your project's requirements. |
| 32 | +- **Changing the Python version**: do you need a different version of python other than 3.11. Just update the first line of each of the Dockerfiles like so: |
| 33 | + `FROM python:3.11-slim-bookworm` to `FROM python:3.10-slim-bookworm` |
| 34 | +- **Setting Environment Variables**: Add environment variables using the `ENV` command for any application-specific configurations. We have prestaged the line needed to inject your OpenAI_key into the docker environment as a environmental variable. Others can be staged in the same way. Just uncomment the line. |
| 35 | + `# ENV OPENAI_API_KEY="{OpenAI-API-Key}"` to `ENV OPENAI_API_KEY="{OpenAI-API-Key}"` |
| 36 | +- **Need a less "Advanced" Autogen build**: If the Dockerfile.full is to much but you need more than advanced then update this line in the Dockerfile.full file. |
| 37 | +`RUN pip install pyautogen[teachable,lmm,retrievechat,mathchat,blendsearch] autogenra` to install just what you need. `RUN pip install pyautogen[retrievechat,blendsearch] autogenra` |
| 38 | +- **Can't Dev without your favorite CLI tool**: if you need particular OS tools to be installed in your Docker container you can add those packages here right after the sudo for the Dockerfile.base and Dockerfile.full files. In the example below we are installing net-tools and vim to the environment. |
| 39 | + |
| 40 | + ```code |
| 41 | + RUN apt-get update \ |
| 42 | + && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \ |
| 43 | + software-properties-common sudo net-tools vim\ |
| 44 | + && apt-get clean \ |
| 45 | + && rm -rf /var/lib/apt/lists/* |
| 46 | + ``` |
| 47 | +
|
| 48 | +### Managing Your Docker Environment |
| 49 | +
|
| 50 | +After customizing your Dockerfile, build the Docker image using the `docker build` command as shown above. To run a container based on your new image, use: |
| 51 | +
|
| 52 | +```bash |
| 53 | +docker run -it -v $(pwd)/your_app:/app your_image_name |
| 54 | +``` |
| 55 | + |
| 56 | +Replace `your_app` with your application directory and `your_image_name` with the name of the image you built. |
| 57 | + |
| 58 | +#### Closing for the Day |
| 59 | + |
| 60 | +- **Exit the container**: Type `exit`. |
| 61 | +- **Stop the container**: Use `docker stop {application_project_name}`. |
| 62 | + |
| 63 | +#### Resuming Work |
| 64 | + |
| 65 | +- **Restart the container**: Use `docker start {application_project_name}`. |
| 66 | +- **Access the container**: Execute `sudo docker exec -it {application_project_name} bash`. |
| 67 | +- **Reactivate the environment**: Run `source /usr/src/app/autogen_env/bin/activate`. |
| 68 | + |
| 69 | +### Useful Docker Commands |
| 70 | + |
| 71 | +- **View running containers**: `docker ps -a`. |
| 72 | +- **View Docker images**: `docker images`. |
| 73 | +- **Restart container setup**: Stop (`docker stop my_container`), remove the container (`docker rm my_container`), and remove the image (`docker rmi my_image:latest`). |
| 74 | + |
| 75 | +#### Troubleshooting Common Issues |
| 76 | + |
| 77 | +- Check Docker daemon, port conflicts, and permissions issues. |
| 78 | + |
| 79 | +#### Additional Resources |
| 80 | + |
| 81 | +For more information on Docker usage and best practices, refer to the [official Docker documentation](https://docs.docker.com). |
0 commit comments