8362e36bb9 | ||
---|---|---|
.github | ||
azure-pipelines | ||
build | ||
client-lite | ||
common | ||
guardian/SDL | ||
licenses | ||
plugins | ||
sdk-cpp | ||
snapcraft-options | ||
.clang-format | ||
.gitattributes | ||
.gitignore | ||
CMakeLists.txt | ||
CMakeSettings.json | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
CPPLINT.cfg | ||
LICENSE | ||
NOTICE.md | ||
README.md | ||
SECURITY.md |
README.md
Delivery Optimization Client
This repository contains source code for the following DO components:
- Agent
- SDK
- Plug-ins
Agent
Delivery Optimization HTTP downloader with Microsoft Connected Cache support.
SDK
Library for enabling inter-process communication (IPC) with deliveryoptimization clients through native C++ code.
Plug-ins
Add-on that enables APT downloads to go through Delivery Optimization Agent. It is a required component only on devices that must download APT packages via a Microsoft Connected Cache instance. During install, it replaces itself as APT's HTTP(S) transport mechanism, thus receiving all APT downloads requests.
Getting Started
Follow the development machine setup on each desktop you'd like to use.
Development Machine Setup
Clone the repository locally from terminal:
> cd (to working directory of your choosing)
> git clone https://github.com/microsoft/do-client
Run the appropriate bootstrapper depending on development machine platform:
> cd build/bootstrap
Building DO client components
NOTICE: If you are modifying this project and distributing your own custom build, please modify the DO_BUILDER_IDENTIFIER cmake variable located in https://github.com/microsoft/do-client/blob/main/CMakeLists.txt
After setting up your development machine, navigate back into the project root
> cd <project root>
We provide an easy-to-use python script for building our client components from the project root, you can inspect build.py for additional build flags On debian-based systems, run this command to build the client and package it as a .deb file
> python3 build/build.py --project agent --package-for deb
Run this command to build the sdk
> python3 build/build.py --project sdk --package-for deb
In order to build the plugin, you must build & install the sdk, an easy way to do this is to install the the packages you produced in the previous two steps
Navigate to the build output directory for the agent and install the agent package
> cd /tmp/build-deliveryoptimization-agent/linux-debug/
> sudo apt-get install ./deliveryoptimization-agent*.deb
The sdk produces a runtime and development package, in this case you'll want to install both Navigate to build output directory for the sdk and install both packages
> cd /tmp/build-deliveryoptimization-sdk/linux-debug/
> sudo apt-get install ./libdeliveryoptimization*.deb
With the sdk installed, you can now build the plugin by navigating back to the project root
> cd <project root>
> python3 build/build.py --project plugin-apt --package-for deb
At this point, you should have built and packaged all components
Installing DO Client components
There are a couple ways for you to install the DO client components
- If you have built the component into a debian package, you can simply find the debian package and install like detailed above. This will handle installing to the appropriate paths, and also the necessary setup of DO user/group permissions needed for DO-agent.
> cd /tmp/build-deliveryoptimization-sdk/linux-debug/
> sudo apt-get install ./libdeliveryoptimization*.deb
> cd /tmp/build-deliveryoptimization-agent/linux-debug/
> sudo apt-get install ./deliveryoptimization-agent*.deb
> cd /tmp/build-deliveryoptimization-plugin-apt/linux-debug/
> sudo apt-get install ./deliveryoptimization-plugin-apt*.deb
- If you build and install using cmake, or through some other custom means, be sure to setup the DO user/groups correctly in your installation. You can reference this script to see how to setup the DO user/group and install DO as a daemon.
Testing DO Client components
As guidance, please ensure proper code coverage for project contributions Unit tests for the agent and sdk are produced as a part of the above build command, you can find them in the build output directory
> cd /tmp/build-deliveryoptimization-agent/linux-debug/client-lite/test
Our tests utilize the GTest unit testing framework, which supports test filtering via command line You can run all agent tests by running
> ./deliveryoptimization-agent-tests
You can filter for specific tests as well, reference the GTest documentation for filtering rules and syntax
> sudo ./deliveryoptimization-agent-tests --gtest_filter=DownloadManagerTests*
The test executable for the SDK is located in the sdk build output as well
> cd /tmp/build-deliveryoptimization-sdk/linux-debug/sdk-cpp/tests
The sdk tests expect a running do-agent, you can either manually run the agent executable from its build output or install the agent package as you may have done while building the plugin You can run the sdk tests just like the agent tests
> sudo ./deliveryoptimization-sdk-tests
And filter them similarly
> sudo ./deliveryoptimization-sdk-tests --gtest_filter=DownloadTests*
Support
The APT plugin component is currently in a Public Preview state. During this phase, it will be supported for 90 days beyond the release date of a new release. At the end of the 90 day window, we will not guarantee support for the previous version. Please plan to migrate to a newer release within that 90-day window to avoid any disruptions.
Filing a Bug
Please file a GitHub Issue to ensure all issues are tracked appropriately.
Build status
Ubuntu 18.04
Architecture | Agent | SDK | Plugin |
---|---|---|---|
x86-64 | |||
arm64 |
Ubuntu 20.04
Architecture | Agent | SDK | Plugin |
---|---|---|---|
x86-64 | |||
arm64 |
Debian 10
Architecture | Agent | SDK | Plugin |
---|---|---|---|
arm32 |
Windows 10/11
Architecture | SDK |
---|---|
x86-64 |
MacOS
Architecture | SDK |
---|---|
x86-64 |
Contact
Directly contact us: docloss@microsoft.com