You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+52-1Lines changed: 52 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,4 +4,55 @@ This project builds the DSPythonNet3 dynamo python engine package.
4
4
5
5
Building the project will output files in `package_output` that can be used to ship as a Dynamo package.
6
6
7
-
Builds are published to [Jenkins](https://master-5.jenkins.autodesk.com/job/Dynamo/job/DSPythonNet3/job/master/) for each commit to `master`.
7
+
Builds are published to [Jenkins](https://master-5.jenkins.autodesk.com/job/Dynamo/job/DSPythonNet3/job/master/) for each commit to `master`.
8
+
9
+
## Deployment
10
+
11
+
The repository uses the release branch to deploy to [Dynamo Package Manager](www.dynamopackages.com).
12
+
13
+
The package `PythonNet3 Engine` is a dynamo package that is consumed by dynamo users using the Package Manager. The following explains the deployment process to continously push updates to that package.
14
+
15
+
The component is published publically to `dynamopackages.com` but is published internally for testing purposes to `dev.dynamopackages.com` by default, to publish a new package or version publically set the `use_dev_pm` flag to `false`, and follow these steps:
16
+
- Make sure that the latest changes are reviewed and merged to the `master` branch.
17
+
- Create a new release branch based on the master branch.The new release branch needs to be named using the following convention:
18
+
- Start the branch name with `release/`
19
+
- If it is a major release, follow it by the major numeric version and the keyword `-major`. Example: release/2-major
20
+
- If it is a minor release, follow it by the major versions and a variable minor version denoted by `x` followed by the keyword `-minor`. Example: release/2.x-minor
21
+
- If it is a patch release, follow it by the major, minor numeric versions and a variable patch version denoted by `x` followed by the keyword `-patch`. Example: release/2.1.x-patch
22
+
- In [Jenkins](https://master-5.jenkins.autodesk.com/job/Dynamo/job/DSPythonNet3/), select the branch and click Build now or Build with Parameters to trigger a new build.
23
+
- After a successful build, a new dynamo package/version will be published to the public dynamo repository, if the flag `use_dev_pm` flag was set to `false`.
24
+
- A PR will be created by the build service user, post build, to merge the new version from the release branch to master. Review and merge to ensure that master is always up-to-date with the latest released version.
25
+
- If for some reason an override of the version is needed, use the flag `package_version` to specify a version that will override the pipeline version.
26
+
27
+
*Note*:
28
+
-*The version of the package depends upon the version specified in the `pipeline.yml` file, the version in the branch name is purely for record-keeping*
29
+
-*The current version of the package that is being deployed should always be semantically greater than the already deployed prior version, i.e package version 2.5.0 cannot be published after 3.0.0 is already published.*
30
+
31
+
**Release Types**
32
+
It is **mandatory** to include at-least one of the release types in the branch name.
33
+
- Use **patch** for a new patch release (backwards-compatible bug fixes, security patches).
34
+
- Use **minor** for a new minor release (add functionality in a backwards-compatible manner).
35
+
- Use **major** for a new major release (incompatible API changes/breaking changes).
0 commit comments