Docker for Development
For developers contributing to the AutoGen project, we offer a specialized Docker environment. This setup is designed to streamline the development process, ensuring that all contributors work within a consistent and well-equipped environment.
Autogen Developer Image (autogen_dev_img)
- Purpose: The
autogen_dev_img
is tailored for contributors to the AutoGen project. It includes a suite of tools and configurations that aid in the development and testing of new features or fixes. - Usage: This image is recommended for developers who intend to contribute code or documentation to AutoGen.
- Forking the Project: It's advisable to fork the AutoGen GitHub project to your own repository. This allows you to make changes in a separate environment without affecting the main project.
- Updating Dockerfile: Modify your copy of
Dockerfile
in thedev
folder as needed for your development work. - Submitting Pull Requests: Once your changes are ready, submit a pull request from your branch to the upstream AutoGen GitHub project for review and integration. For more details on contributing, see the AutoGen Contributing page.
Building the Developer Docker Image
-
To build the developer Docker image (
autogen_dev_img
), use the following commands:docker build -f .devcontainer/dev/Dockerfile -t autogen_dev_img https://github.com/microsoft/autogen.git#main
-
For building the developer image built from a specific Dockerfile in a branch other than main/master
# clone the branch you want to work out of
git clone --branch {branch-name} https://github.com/microsoft/autogen.git
# cd to your new directory
cd autogen
# build your Docker image
docker build -f .devcontainer/dev/Dockerfile -t autogen_dev-srv_img .
Using the Developer Docker Image
Once you have built the autogen_dev_img
, you can run it using the standard Docker commands. This will place you inside the containerized development environment where you can run tests, develop code, and ensure everything is functioning as expected before submitting your contributions.
docker run -it -p 8081:3000 -v `pwd`/autogen-newcode:newstuff/ autogen_dev_img bash
- Note that the
pwd
is shorthand for present working directory. Thus, any path after the pwd is relative to that. If you want a more verbose method you could remove the "pwd
/autogen-newcode" and replace it with the full path to your directory
docker run -it -p 8081:3000 -v /home/AutoGenDeveloper/autogen-newcode:newstuff/ autogen_dev_img bash
Develop in Remote Container
If you use vscode, you can open the autogen folder in a Container. We have provided the configuration in devcontainer. They can be used in GitHub codespace too. Developing AutoGen in dev containers is recommended.