Skip to content

Commit

Permalink
Replace deprecated terminology
Browse files Browse the repository at this point in the history
  • Loading branch information
MarkEWaite committed Feb 22, 2021
1 parent 1eff4f1 commit a996292
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ The goals are the maximum possible compatibility with existing plugins, and grea

A freestyle project has a single SCM configured in the UI that governs the one and only workspace for the build.
A Pipeline can be configured similarly, but the SCM definition becomes a regular step in its script.
In the simplest case you would just do an SCM clone/update at the start of your script, as soon as you have allocated a slave with a workspace:
In the simplest case you would just do an SCM clone/update at the start of your script, as soon as you have allocated an agent with a workspace:

```
node {
Expand All @@ -23,15 +23,15 @@ node {
```

Jenkins will clone the repository into the workspace and continue with your script.
(Subsequent builds will update rather than clone, if the same slave and workspace are available again.)
(Subsequent builds will update rather than clone, if the same agent and workspace are available again.)

### Multiple SCMs

While freestyle projects can use the Multiple SCMs plugin to check out more than one repository,
or specify multiple locations in SCM plugins that support that (notably the Git plugin),
this support is quite limited.
In a Pipeline you can check out multiple SCMs, of the same or different kinds, in the same or different workspaces, wherever and whenever you like.
For example, to check out and build several repositories in parallel, each on its own slave:
For example, to check out and build several repositories in parallel, each on its own agent:

```
parallel repos.collectEntries {repo -> [/* thread label */repo, {
Expand All @@ -57,7 +57,7 @@ This means that you can run multiple SCMs, even from a dynamic list, and get a r

If you configure the _Poll SCM_ trigger in the Pipeline’s UI configuration screen, then by default Jenkins will also poll for changes according to the selected _Schedule_, and schedule new builds automatically if changes are detected.
(Note that this configuration is not part of the Pipeline script, because it affects activities that Jenkins runs outside of the Pipeline.)
Some SCMs allow polling with no workspace, which is ideal; others will try to lock the same slave and workspace previously used, to run polling on the slave.
Some SCMs allow polling with no workspace, which is ideal; others will try to lock the same agent and workspace previously used, to run polling on the agent.

To avoid polling the server repeatedly, most SCM plugins allow remote commit triggers, such as the `/git/notifyCommit?url=…` HTTP endpoint in the case of the Git plugin.
These also work with Pipelines, unless (as with freestyle projects) you checked _Ignore post-commit hooks_ in a _Poll SCM_ block.
Expand Down

0 comments on commit a996292

Please sign in to comment.