How to Release Plugin Manager / Plugin Parent
Background ¶
The Plugin Manager / Plugin Parent, developed by the MCT team, is distributed via the Maven repository for use by plugin developers. The release process follows the Maven usage guideline and utilizes the Cisco IT Maven repository.
Release Steps ¶
1. Code Cloning ¶
Clone the project from GitHub.
2. Code Modification ¶
Make the necessary changes and commit your updates.
3. Building the Artifact ¶
Run the following Maven command to build the artifact without running tests:
~~~sh
mvn -DskipTests clean package
~~~
Users can skip this step for Plugin Parent release
4. Authentication ¶
4.1 Joining Target Group ¶
Ensure you're a member of the cscmse-group. If not already, request access from Selly Huang.
4.2 Token Generation ¶
- Generate an identity token on the Cisco IT Maven repo profile page.
- Add the generated token to your Maven settings (usually
~/.m2/settings.xml):<servers> <server> <id>bms-artifactory-rel</id> <username>${your cec}</username> <password>${generated token}</password> </server> </servers>
5. Artifact Deployment ¶
Deploy the artifact to the Cisco IT Maven Repository using the following command:
# for plugin manager
mvn deploy:deploy-file -Durl=https://engci-maven.cisco.com/artifactory/cscmse-release -DrepositoryId=bms-artifactory-rel -Dfile=${path/to/jar} -DgroupId=com.webex.mct -DartifactId=plugin-manager -Dversion=${version} -Dpackaging=jar -DgeneratePom=true -DpomFile=${path/to/pom}
# for plugin parent
mvn deploy:deploy-file -Durl=https://engci-maven.cisco.com/artifactory/cscmse-release -DrepositoryId=bms-artifactory-rel -Dfile=${path/to/pom} -DgroupId=com.webex.mct -DartifactId=java-plugin-parent -Dversion=${version} -Dpackaging=pom -DgeneratePom=true -DpomFile=${path/to/pom}
Replace ${path/to/jar} with the actual Jar file path, ${path/to/pom} with the actual POM file path, and ${version} with the Jar file's version.
e.g. under ~/mct-java-plugin/middleware/java-plugin-parent/
mvn deploy:deploy-file -Durl=https://engci-maven.cisco.com/artifactory/cscmse-release -DrepositoryId=bms-artifactory-rel -Dfile=pom.xml -DgroupId=com.webex.mct -DartifactId=java-plugin-parent -Dversion=2.0.0 -Dpackaging=pom -DgeneratePom=true -DpomFile=pom.xml
6. Verification ¶
Verify the artifact is successful upload by checking the Maven repository.
