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:28] 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. |
| - | * **source file:** 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 | + | |
| - | * **source file:**needs to be created manually and stored | + | |
| - | * http://artifacts.opnfv.org/arno.2015.2.0/fuel/release-notes.arno.2015.2.0.pdf | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**needs to be created manually and stored | + | |
| - | * http://artifacts.opnfv.org/arno.2015.2.0/foreman/release-notes.arno.2015.2.0.pdf | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**http://artifacts.opnfv.org/functest/docs/functest.pdf | + | |
| - | * http://artifacts.opnfv.org/arno.2015.2.0/docs/pharos-spec.arno.2015.2.0.pdf | + | |
| - | * **source file:**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 | + | |
| - | * **source file:**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. | + | 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 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 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. | ||
| - | |||