-
Notifications
You must be signed in to change notification settings - Fork 6.8k
Static build instruction for MXNet in general #13914
Static build instruction for MXNet in general #13914
Conversation
Thanks @lanking520 to enable MKLDNN backend for Maven build. Feel free to ping me if anything we can help. |
@mxnet-label-bot add [pr-awaiting-review] |
59a5631
to
8bb808b
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
@@ -0,0 +1,33 @@ | |||
# MXNet Publish Settings | |||
|
|||
This folder contains the configuration of restricted node on Jenkins for the publish. It also contains a folder called `scala` that contains everything required for scala publish. In this `README`, we would bring a brief walkthrough of the Jenkins configuration as well as the usages of the scala deployment files. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This folder contains the configuration of restricted node on Jenkins for the publish. It also contains a folder called `scala` that contains everything required for scala publish. In this `README`, we would bring a brief walkthrough of the Jenkins configuration as well as the usages of the scala deployment files. | |
This folder contains the configuration for restricted nodes on Jenkins for the publishing MXNet artifacts. It also contains a folder called `scala` that contains everything required for publishing to Maven. In this `README`, we provide a brief walkthrough of the Jenkins configuration as well as the usage of the Scala deployment files. Python publishing is TBD. |
This folder contains the configuration of restricted node on Jenkins for the publish. It also contains a folder called `scala` that contains everything required for scala publish. In this `README`, we would bring a brief walkthrough of the Jenkins configuration as well as the usages of the scala deployment files. | ||
|
||
## Jenkins | ||
Currently, Jenkins contains three build stages, namely `Build Packages`, `Test Packages` and `Deploy Packages`. During the `build package` stages, all dependencies will be built and a Scala package would be created. In the second stage, the package created from the previous stage would move to this stage to specifically run the tests. In the final stage, the packages passed the test would be deployed by the instances. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Currently, Jenkins contains three build stages, namely `Build Packages`, `Test Packages` and `Deploy Packages`. During the `build package` stages, all dependencies will be built and a Scala package would be created. In the second stage, the package created from the previous stage would move to this stage to specifically run the tests. In the final stage, the packages passed the test would be deployed by the instances. | |
Currently, Jenkins contains three build stages, namely `Build Packages`, `Test Packages` and `Deploy Packages`. During the `build package` stages, all dependencies are built and a Scala package are created. In the second stage, the package created from the previous stage moves to this stage to specifically run the tests. In the final stage, the packages that pass the tests are deployed by the instances. |
|
||
Apart from that, the script used to create the environment and publish are available under `ci/docker/install`: | ||
|
||
- `ubuntu_publish.sh` install all required dependencies for Ubuntu 14.04 for publishing |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- `ubuntu_publish.sh` install all required dependencies for Ubuntu 14.04 for publishing | |
- `ubuntu_publish.sh` installs all required dependencies for Ubuntu 14.04 for publishing |
Apart from that, the script used to create the environment and publish are available under `ci/docker/install`: | ||
|
||
- `ubuntu_publish.sh` install all required dependencies for Ubuntu 14.04 for publishing | ||
- `ubuntu_base.sh` install minimum dependencies required to run the published packages |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- `ubuntu_base.sh` install minimum dependencies required to run the published packages | |
- `ubuntu_base.sh` installs minimum dependencies required to run the published packages |
- `ubuntu_base.sh` install minimum dependencies required to run the published packages | ||
|
||
## Scala publish | ||
Currently Scala publish on Linux is fully supported on jenkins. The `scala/` folder contains all files needed to do the publish. Here is a breif instroduction of the files: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Currently Scala publish on Linux is fully supported on jenkins. The `scala/` folder contains all files needed to do the publish. Here is a breif instroduction of the files: | |
Currently Scala publish on Linux is fully supported on Jenkins. The `scala/` folder contains all files needed for publishing. Here is a brief introduction of the files: |
@@ -0,0 +1,32 @@ | |||
# MXNet Static build | |||
|
|||
This folder contains the core script used to build the static library. This README would bring you the information and usages of the script in here. Please be aware, all of the scripts are designed to be run under the root folder. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This folder contains the core script used to build the static library. This README would bring you the information and usages of the script in here. Please be aware, all of the scripts are designed to be run under the root folder. | |
This folder contains the core script used to build the static library. This README provides information on how to use the scripts in this folder. Please be aware, all of the scripts are designed to be run under the root folder. |
This folder contains the core script used to build the static library. This README would bring you the information and usages of the script in here. Please be aware, all of the scripts are designed to be run under the root folder. | ||
|
||
## `build.sh` | ||
This script is a wrapper around `build_lib.sh` aimed to simplify the usage of it. It would automatically identify the system version, number of cores and all environment variable settings. Here are the examples you can run this script: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This script is a wrapper around `build_lib.sh` aimed to simplify the usage of it. It would automatically identify the system version, number of cores and all environment variable settings. Here are the examples you can run this script: | |
This script is a wrapper around `build_lib.sh. It simplifies the things by automatically identifing the system version, number of cores, and all environment variable settings. Here are examples you can run with this script: |
As the result, users would have a complete static dependencies in `/staticdeps` in the root folder as well as a static-linked `libmxnet.so` file lives in `lib`. You can build your language binding by using the `libmxnet.so`. | ||
|
||
## `build_lib.sh` | ||
This script would clone the most up-to-date master and build the MXNet backend with static library. In order to run that, you should have prepare the the following environment variable: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This script would clone the most up-to-date master and build the MXNet backend with static library. In order to run that, you should have prepare the the following environment variable: | |
This script clones the most up-to-date master and builds the MXNet backend with a static library. In order to run the static library, you must set the the following environment variables: |
After running this script, you would have everything you need ready in the `/lib` folder. | ||
|
||
## `build_wheel.sh` | ||
This script is used to build the python package as well as running a sanity test |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This script is used to build the python package as well as running a sanity test | |
This script builds the python package. It also runs a sanity test. |
- `ubuntu_publish.sh` install all required dependencies for Ubuntu 14.04 for publishing | ||
- `ubuntu_base.sh` install minimum dependencies required to run the published packages | ||
|
||
## Scala publish |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## Scala publish | |
## Scala Publishing |
* update scripts and tutorial * add the static test for scala package * kill publish test * fix build issue * address comments
* update scripts and tutorial * add the static test for scala package * kill publish test * fix build issue * address comments
* update scripts and tutorial * add the static test for scala package * kill publish test * fix build issue * address comments
* update scripts and tutorial * add the static test for scala package * kill publish test * fix build issue * address comments
* update scripts and tutorial * add the static test for scala package * kill publish test * fix build issue * address comments
* update scripts and tutorial * add the static test for scala package * kill publish test * fix build issue * address comments
Description
Adding instructions for Static build and a static build test stage in CI. Also make the mkldnn as a default on Maven publish and enable signal_handler for segfault.
@frankfliu @szha @marcoabreu @zachgk @gigasquid
Checklist
Essentials
Please feel free to remove inapplicable items for your PR.