Oryx is a build system which automatically compiles source code repos into runnable artifacts. It is used to build web apps for Azure App Service and other platforms.
To receive updates on runtimes and versions supported by Oryx and App Service, subscribe to Azure Updates or watch the github.com/Azure/app-service-announcements tracker.
Oryx generates and runs an opinionated build script within a build container
based on analysis of a codebase's contents. For example, if package.json
is
discovered in the repo Oryx includes npm run build
in the build script; or if
requirements.txt
is found it includes pip install -r requirements.txt
.
Oryx also generates a run-time startup script for the app including typical
start commands like npm run start
for Node.js or a WSGI module and server
for Python.
The built artifacts and start script are loaded into a minimalistic run container and run.
Runtime | Version |
---|---|
Python | 2.7 3.6, 3.7 |
Node.js | 4.4, 4.5, 4.8 6.2, 6.6, 6.9, 6.10, 6.11 8.0, 8.1, 8.2, 8.8, 8.9, 8.11, 8.12 9.4 10.1, 10.10, 10.14, 10.15 |
.NET Core | 1.0, 1.1 2.0, 2.1, 2.2 |
Patches (0.0.x) are applied as soon as possible after they are released upstream.
Though built first for use within Azure services, you can also use the Oryx build system yourself for troubleshooting and tests. Following are simple instructions; for complete background see our architecture doc.
Oryx includes two command-line applications; the first is included in the
build image and generates a build script by analyzing a codebase. The second
is included in run images and generates a startup script. Both are aliased
and accessible as oryx
in their respective images.
When oryx build
is run, the system detects which programming platforms appear
to be in use and applies toolsets appropriate for each one. You can override
the default choices through configuration.
The --output
(or -o
) parameter specifies where prepared artifacts will be
placed; if not specified the source directory is used for output as well.
For all options, specify oryx --help
.
When oryx
is run in the runtime images it generates a start script named
run.sh, by default in the same folder as the compiled artifact.
To build and run an app from a repo, follow these approximate steps. An example script follows.
- Mount the repo as a volume in Oryx's
mcr.microsoft.com/oryx/build
container. - Run
oryx build ...
within the repo directory to build a runnable artifact. - Mount the output directory from build in an appropriate Oryx "run"
container, such as
mcr.microsoft.com/oryx/node-10.14
. - Run
oryx ...
within the "run" container to write a startup script. - Run the generated startup script, by default
./run.sh
.
# Run these from the root of the repo.
# build
docker run --volume $(pwd):/repo \
'mcr.microsoft.com/oryx/build:latest' \
'oryx build /repo --output /repo/out'
# run
# include `-p port:port` and `-e KEY=value`
# to open ports and set environment variables
docker run --detach --rm \
--volume $(pwd)/out:/app \
# -p 80:80 \
# -e MYKEY=value \
'mcr.microsoft.com/oryx/node-10.14:latest' \
sh -c 'oryx -appPath /app && /app/run.sh'
See CONTRIBUTING.md.
MIT, see LICENSE.md.
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at [email protected]. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.
When utilized within Azure services, this project collects usage data and sends it to Microsoft to help improve our products and services. Read Microsoft's privacy statement to learn more.
This project follows the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ. Contact [email protected] with questions and comments.