This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
octopus:releasepipeline [2015/10/01 14:06] Fatih Degirmenci |
octopus:releasepipeline [2016/02/24 18:44] (current) Aric Gardner |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== OPNFV Process to prepare the release ====== | ====== OPNFV Process to prepare the release ====== | ||
- | This page describes the steps to prepare the Arno release. | + | This page describes the steps to prepare the Brahmaputra release. |
- | For later releases there will be a different process. | + | |
- | ====== Arno SR1 Release ====== | + | ====== Brahmaputra Release ====== |
- | ===== Steps to take for Release ===== | + | PTLs of Brahmaputra participating projects are responsible of |
- | - Based on input from BGS and FuncTest, TSC decides on | + | * Identifying the SHA1 to apply the tag on and release |
- | * The exact version of ISO, deploy and test scripts and documents to use in the release | + | * Tagging the SHA1 with the release tag, **brahmaputra.1.0** |
- | * The release tag name | + | * If valid, tagging the Docker images with the release tag, **brahmaputra.1.0** |
- | - Based on the decision of TSC, Octopus identifies/extracts the SHA1s for the repos genesis and functest from Jenkins build/deploy/test jobs. | + | * Identifying the exact versions of the artifacts (ISO, RPM, documents, etc. if valid) with the help from documentation, infra, and LF. |
- | - Octopus identifies SHA1s for the repos pharos, octopus, opnfvdocs, and releng and confirms them with respective PTLs. | + | * Making sure the correct artifacts are linked/referred on release page. |
- | - Octopus provides git instructions to PTLs in order to apply tags. | + | |
- | - PTLs tag corresponding/identified revisions/SHA1s in all the repos that are part of the release with agreed tag. (genesis, functest, pharos, octopus, opnfvdocs, releng) | + | |
- | - Octopus team run final deploy and verify on the release revision. | + | |
- | - Once validated LF copies the final artifacts and documents to Arno release storage (see below): | + | |
- | - LF creates links to released artifacts and documents on download pages: www.opnfv.org/software/download | + | |
- | - Marketing team send release announcement mail. | + | |
- | ===== Release Tag ===== | + | ===== Steps to take for Brahmaputra Release ===== |
- | arno.2015.2.0 | + | * PTLs tag corresponding/identified revisions/SHA1s on **stable/brahmaputra** branch in respective repos |
+ | * LF is notified regarding the final release artifacts | ||
+ | * LF copies the final release artifacts and documents to Brahmaputra release storage | ||
+ | * LF creates links to released artifacts and documents on download pages: www.opnfv.org/software/<tbd> | ||
+ | * Marketing team send release announcement mail | ||
- | ===== Maintenance Branch ===== | + | ===== Brahmaputra Release Tag ===== |
- | stable/arno (this branch already exists) | + | **brahmaputra.1.0** |
- | ===== Storage Locations for Final Artifacts ===== | + | ===== Storage Locations for Final Brahmaputra Artifacts ===== |
+ | TBD | ||
- | **PELIMINARY** | + | ====== Brahmaputra git tagging instructions ====== |
- | * http://artifacts.opnfv.org/arno.2015.2.0/fuel/arno.2015.2.0.fuel.iso | + | PTLs of Brahmaputra participating projects will apply the tags in respective repos. |
- | * http://artifacts.opnfv.org/genesis/fuel/arno/opnfv-2015-10-01_07-12-53.iso | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/fuel/arno.2015.2.0.fuel.iso.md5sum | + | |
- | * needs to be created manually and stored | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/fuel/release-notes.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/genesis/arno/fuel/docs/src/release-notes.pdf | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/fuel/install-guide.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/genesis/arno/fuel/docs/src/installation-instructions.pdf | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/foreman/arno.2015.2.0.foreman.iso | + | |
- | * http://artifacts.opnfv.org/genesis/foreman/arno/opnfv-2015-10-01_11-21-52.iso | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/foreman/arno.2015.2.0.foreman.iso.md5sum | + | |
- | * needs to be created manually and stored | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/foreman/release-notes.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/genesis/arno/foreman/docs/src/release-notes.pdf | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/foreman/install-guide.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/genesis/arno/foreman/docs/src/installation-instructions.pdf | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/docs/user-guide.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/genesis/arno/common/docs/user-guide.pdf **(no change)** | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/docs/functest.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/functest/docs/functest.pdf | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/docs/pharos-spec.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/pharos/docs/pharos-spec.pdf **(no change)** | + | |
- | * http://artifacts.opnfv.org/arno.2015.2.0/docs/opnfv-jenkins-slave-connection.arno.2015.2.0.pdf | + | |
- | * http://artifacts.opnfv.org/octopus/arno/docs/opnfv-jenkins-slave-connection.pdf | + | |
- | ====== git instructions ====== | + | ===== SHA1s to Apply Tags on for SR1 ===== |
- | Committers will apply the tags to the genesis, octopus, releng*, pharos, functest and opnfvdocs repos and create branches for maintenance. | + | SHA1s of the repos are identified by PTLs. If the project is integrated to other projects (such as installer projects) it is important to communicate with these projects as well. |
- | ===== SHA1s to Apply Tags and Create Branches on ===== | + | To select the SHA1 to apply the tag for, you can use Gerrit web interface or the git commands as listed below. |
- | ^ Repo ^ SHA1 ^ Tag/Branch Status ^ | + | * Using Gerrit Web Interface: |
- | | genesis | c5721ee | TBD | | + | * https://gerrit.opnfv.org/gerrit/gitweb?p=<**YOUR PROJECT NAME**>.git;a=shortlog;h=refs/heads/stable/brahmaputra |
- | | functest | 19c7d0e | TBD | | + | * Click one of the commits listed on the page. The SHA1 is the one listed in commit field. |
- | | pharos | cdf8591 | TBD | | + | * Using Git command |
- | | opnfvdocs| 9d00c5d | TBD | | + | * git checkout stable/brahmaputra |
- | | octopus | 4dc6414 | TBD | | + | * git log --graph |
- | | releng | 70abf2a | TBD | | + | |
- | |||
- | ===== Tagging ===== | ||
- | |||
- | * git fetch origin | ||
- | * git checkout <**SHA1**> | ||
- | * git tag -am "arno.2015.2.0" arno.2015.2.0 | ||
- | * git push origin arno.2015.2.0 | ||
- | |||
- | Please get the SHA1 for your project from the table above. | ||
- | |||
- | Please contact aricg and/or other Octopus members on #opnfv-octopus channel if you experience any issues. | ||
- | |||
- | ====== Arno Release ====== | ||
- | |||
- | ===== Steps to take for Release ===== | ||
- | |||
- | - Based on input from BGS and FuncTest, TSC decides on | ||
- | * The exact version of ISO, deploy and test scripts and documents to use in the release | ||
- | * The release tag name | ||
- | - Based on the decision of TSC, Octopus identifies/extracts the SHA1s for the repos genesis and functest from Jenkins build/deploy/test jobs. | ||
- | - Octopus identifies SHA1s for the repos pharos, octopus, opnfvdocs, and releng and confirms them with respective PTLs. | ||
- | - Octopus provides git instructions to PTLs in order to apply tags. | ||
- | - PTLs tag corresponding/identified revisions/SHA1s in all the repos that are part of the release with agreed tag. (genesis, functest, pharos, octopus, opnfvdocs, releng) | ||
- | - PTLs create maintenance branch in all the repos for the projects that are participating in Arno. \\ (Instructions will be provided by Octopus). | ||
- | - Octopus team run final deploy and verify on the release revision. | ||
- | - Once validated LF copies the final artifacts and documents to Arno release storage (see below): | ||
- | - LF creates links to released artifacts and documents on download pages: www.opnfv.org/software/download | ||
- | - Marketing team send release announcement mail. | ||
- | |||
- | ===== Release Tag ===== | ||
- | |||
- | arno.2015.1.0 | ||
- | |||
- | ===== Maintenance Branch ===== | ||
- | |||
- | stable/arno | ||
- | |||
- | ===== Storage Locations for Final Artifacts ===== | ||
- | |||
- | * http://artifacts.opnfv.org/arno.2015.1.0/fuel/arno.2015.1.0.fuel.iso | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/fuel/arno.2015.1.0.fuel.iso.md5sum | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/fuel/release-notes.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/fuel/install-guide.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/foreman/arno.2015.1.0.foreman.iso | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/foreman/arno.2015.1.0.foreman.iso.md5sum | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/foreman/release-notes.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/foreman/install-guide.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/docs/user-guide.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/docs/functest.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/docs/pharos-spec.arno.2015.1.0.pdf | ||
- | * http://artifacts.opnfv.org/arno.2015.1.0/docs/opnfv-jenkins-slave-connection.arno.2015.1.0.pdf | ||
- | |||
- | ====== git instructions ====== | ||
- | |||
- | Committers will apply the tags to the genesis, octopus, releng*, pharos, functest and opnfvdocs repos and create branches for maintenance. | ||
- | |||
- | ===== SHA1s to Apply Tags and Create Branches on ===== | ||
- | |||
- | ^ Repo ^ SHA1 ^ Tag/Branch Status ^ | ||
- | | genesis | 321aff9 | Done | | ||
- | | functest | 3af6557 | Done | | ||
- | | pharos | cdf8591 | Done | | ||
- | | opnfvdocs| 9d00c5d | Done | | ||
- | | octopus | 4da0ef5 | Done | | ||
- | | releng | 305051a | Done | | ||
Line 141: | Line 50: | ||
* git fetch origin | * git fetch origin | ||
+ | * git checkout stable/brahmaputra | ||
* git checkout <**SHA1**> | * git checkout <**SHA1**> | ||
- | * git tag -am "arno.2015.1.0" arno.2015.1.0 | + | * git tag -am "brahmaputra.1.0" brahmaputra.1.0 |
- | * git push origin arno.2015.1.0 | + | * git push origin brahmaputra.1.0 |
- | Please get the SHA1 for your project from the table above. | + | If you get the error |
+ | ! [remote rejected] brahmaputra.1.0 -> brahmaputra.1.0 (prohibited by Gerrit) | ||
+ | This is because you are not the author of the commit being tagged. email helpdesk and I will add forge rights to refs/tags/* on your repo. | ||
- | Please contact aricg and/or other Octopus members on #opnfv-octopus channel if you experience any issues. | ||
- | ===== Branching ===== | ||
- | |||
- | * Click the link for your project from below list | ||
- | * genesis: https://gerrit.opnfv.org/gerrit/#/admin/projects/genesis,branches | ||
- | * functest: https://gerrit.opnfv.org/gerrit/#/admin/projects/functest,branches | ||
- | * pharos: https://gerrit.opnfv.org/gerrit/#/admin/projects/pharos,branches | ||
- | * octopus: https://gerrit.opnfv.org/gerrit/#/admin/projects/octopus,branches | ||
- | * opnfvdocs: https://gerrit.opnfv.org/gerrit/#/admin/projects/opnfvdocs,branches | ||
- | * Fill in the boxes as shown below | ||
- | * Branch Name: stable/arno | ||
- | * Initial Revision: <**SHA1**> | ||
- | * Click "Create Branch" | ||
- | |||
- | Please get the SHA1 for your project from the table above. | ||
Please contact aricg and/or other Octopus members on #opnfv-octopus channel if you experience any issues. | Please contact aricg and/or other Octopus members on #opnfv-octopus channel if you experience any issues. | ||
- | |||
- | Please note that releng won't be branched off. | ||
- |