{"id":15045349,"url":"https://github.com/jenkinsci/plasticscm-plugin","last_synced_at":"2025-08-30T07:31:16.849Z","repository":{"id":1399581,"uuid":"1422147","full_name":"jenkinsci/plasticscm-plugin","owner":"jenkinsci","description":"A plugin for Jenkins to be able to use Plastic SCM","archived":false,"fork":false,"pushed_at":"2024-08-26T08:05:44.000Z","size":2525,"stargazers_count":17,"open_issues_count":8,"forks_count":31,"subscribers_count":103,"default_branch":"master","last_synced_at":"2025-05-07T19:02:35.530Z","etag":null,"topics":["jenkins","plastic","plastic-scm","plasticscm","plugin","scm"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"madalinoprea/magneto-varnish","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-02-28T16:16:52.000Z","updated_at":"2025-04-09T10:09:10.000Z","dependencies_parsed_at":"2023-07-11T07:34:16.741Z","dependency_job_id":"a6d7cfdb-3a95-42e0-b490-31b8951e3c72","html_url":"https://github.com/jenkinsci/plasticscm-plugin","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/jenkinsci/plasticscm-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplasticscm-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplasticscm-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplasticscm-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplasticscm-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/plasticscm-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fplasticscm-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272821182,"owners_count":24998599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jenkins","plastic","plastic-scm","plasticscm","plugin","scm"],"created_at":"2024-09-24T20:51:45.989Z","updated_at":"2025-08-30T07:31:16.468Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n    \u003cimg src=\"doc/img/logo-plasticscm.svg\" alt=\"Plastic SCM Logo\" width=\"450\" /\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    Retrieve and manage your Plastic SCM sources from Jenkins.\n\u003c/p\u003e\n\n---\n\n![Plugin Version](https://img.shields.io/jenkins/plugin/v/plasticscm-plugin.svg?label=version)\n[![Build Status](https://ci.jenkins.io/buildStatus/icon?job=Plugins/plasticscm-plugin/master)](https://ci.jenkins.io/job/Plugins/job/plasticscm-plugin/job/master/)\n![Installs](https://img.shields.io/jenkins/plugin/i/plasticscm-plugin.svg?color=blue)\n\n\u003c!-- TOC --\u003e\n* [Overview](#overview)\n* [How to use the plugin](#how-to-use-the-plugin)\n  * [Installing the Plastic SCM client](#installing-the-plastic-scm-client)\n  * [Standalone mode](#standalone-mode)\n  * [Mergebot mode](#mergebot-mode)\n* [Build information](#build-information)\n  * [Summary](#summary)\n  * [Changes list](#changes-list)\n  * [Plastic SCM Build Data](#plastic-scm-build-data)\n* [Requirements](#requirements)\n* [Upgrades](#upgrades)\n  * [Upgrading from 3.x to 4.x](#upgrading-from-3x-to-4x)\n  * [Upgrading from 2.x to 3.x](#upgrading-from-2x-to-3x)\n* [Development](#development)\n  * [Building the Plugin](#building-the-plugin)\n  * [Contributing to the Plugin](#contributing-to-the-plugin)\n* [Plugin information](#plugin-information)\n* [Change log](#change-log)\n\u003c!-- TOC --\u003e\n\n# Overview\n\nPlastic SCM is a scalable, engine-agnostic version control and source code management tool for game development studios\nof all sizes. It offers optimized workflows for artists and programmers and superior speed working with large files and\nbinaries.\n\nThis plugin integrates Plastic SCM with Jenkins, allowing you to retrieve and manage your Plastic SCM sources from\nJenkins projects and pipelines. It also provides a way to automatically download and install the Plastic SCM client\n(`cm`) in the controller or agent machines.\n\n# How to use the plugin\n\n## Installing the Plastic SCM client\n\nThe Plastic SCM plugin for Jenkins requires a working `cm` client to be present in the controller or agent machines.\nIf it's not, the plugin provides a way for the machines to automatically download and install the client.\n\nYou can find out more about how to configure the Plastic SCM client in Jenkins in the\n[External Tool Configuration guide](doc/external-tool-configuration.md).\n\n## Standalone mode\n\nThe Plastic SCM plugin for Jenkins can be used in standalone mode. This behaves as a regular SCM plugin, where the\nproject configuration defines which repository to use and the credentials to connect to it. The plugin will then\ndownload the sources to the workspace.\n\nYou can find out more about how to configure the Plastic SCM plugin in standalone mode in the\n[Standalone mode guide](doc/standalone-guide.md).\n\n## Mergebot mode\n\nThe Plastic SCM plugin for Jenkins can be used in Mergebot mode. This mode is intended to be used in conjunction with\nthe [Plastic SCM Mergebot](https://blog.plasticscm.com/2018/09/mergebot-story-of-our-devops-initiative.html)\nfeature.\n\nA Mergebot will trigger a CI build, which will be requested to Jenkins via a Plug. The targeted Jenkins project will\nneed to have the Plastic SCM plugin configured in Mergebot mode. The plugin will then download the sources to the\nworkspace, taking the required spec from a build parameter.\n\nYou can find out more about how to configure the Plastic SCM plugin in Mergebot mode in the\n[Mergebot mode guide](doc/mergebot-guide.md).\n\n\n# Build information\n\n## Summary\n\nThe build summary includes a reference to the Plastic SCM changeset spec that was built.\n\n![Build summary](doc/img/build-summary.png)\n\n## Changes list\n\nThe changes page in each build will have details about each of the changesets that were included in\nthe build, linked from the summary list.\n\n![Changes summary](doc/img/changes-summary.png)\n\n## Plastic SCM Build Data\n\nYou'll find a link in the build page sidebar to display the Plastic SCM data for that build.\n\n![Build data](doc/img/Plastic-SCM-Build-Data.png)\n\n# Requirements\n\n* Jenkins `2.440.3` (2024-04-17) or newer\n* Plastic SCM command line client `10.0.16.6112` or newer\n\n# Upgrades\n\n## Upgrading from 3.x to 4.x\n\nThere are no incompatibilities in configuration from version 3.x to version 4.x. The latter adds\nsupport in project/pipeline configurations to specify a Plastic SCM working mode and credentials.\n\nBy default, new or existing projects will use the default credentials for `cm` as configured in the\ncontroller or agent machines. This means that upgrading will keep the same behaviour as you had in\nthe previous version.\n\n## Upgrading from 2.x to 3.x\n\nThe upgrade process is mostly seamless. You'll only need to review the configuration parameters of\nyour jobs **if you configured them to use multiple workspaces**. Since the subdirectory name was\ninferred from the workspace name before and that parameter is now gone, the **Subdirectory**\nparameter (used now to specify the subdirectory name explicitly) will be empty. Builds might\ndownload all workspaces in the same directory!\n\n# Development\n\n## Building the Plugin\n\nTo build the plugin you will need:\n\n* [Maven](https://maven.apache.org/) version `3.5` or newer\n* [Java Development Kit (JDK)](https://jdk.java.net/) version `17`\n\nRun the following command to build the plugin:\n\n```shell\nmvn package\n```\n\n## Contributing to the Plugin\n\nNew feature requests and bug fix proposals should be submitted as\n[pull requests](https://help.github.com/en/articles/creating-a-pull-request).\nFork the repository. Make the desired changes in your forked copy. Submit a pull request to the\n`master` branch.\n\nUse the [Jenkins SCM API coding style guide](https://github.com/jenkinsci/scm-api-plugin/blob/master/CONTRIBUTING.md#code-style-guidelines)\nfor new code.\n\nBefore submitting a pull request please check if your code passes code quality and style checks by\nrunning:\n\n```shell\nmvn verify\n```\n\nAll pull requests will be evaluated by\n[Jenkins CI](https://ci.jenkins.io/job/Plugins/job/plasticscm-plugin/).\n\n# Plugin information\n\nThis plugin is developed and maintained by Unity Software, owner of the Plastic SCM product.\n\nVisit us at \u003chttps://unity.com/solutions/version-control\u003e.\n\nWe really appreciate PR and contributions!\n\n# Change log\n\nYou can find it [here](CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fplasticscm-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Fplasticscm-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fplasticscm-plugin/lists"}