Publish Over CIFS Plugin

Skip to end of metadata
Go to start of metadata

Send build artifacts to a windows share (CIFS/SMB/samba)

Plugin Information

Plugin ID publish-over-cifs Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
0.3
Dec 29, 2013
1.532.1
Source Code
Issue Tracking
Maintainer(s)
GitHub
Open Issues
slide (id: slide_o_mix)
Bap (id: bap)
Usage Installations 2013-Apr 1248
2013-May 1290
2013-Jun 1387
2013-Jul 1462
2013-Aug 1464
2013-Sep 1486
2013-Oct 1542
2013-Nov 1573
2013-Dec 1583
2014-Jan 1694
2014-Feb 1731
2014-Mar 1848

Publish Over ...

Read Publish Over ... wiki page first
Please read Publish Over first.
Common configuration options that are documented in the Publish Over ... wiki page will not be repeated here.

Features
Configure
Change log

Features

  • Send files to windows shares
  • The plugin is "promotion aware" see Promotions
  • Publish to multiple shares in the "Post-build Actions"
  • Passwords are encrypted in the configuration files and in the UI
  • Copy files to a windows share during a build

Configure

Configure a WINS server

From the Jenkins home page, click "Manage Jenkins" and the click on "Configure System"

In the main Jenkins configuration page, there will be a "Publish Over CIFS" checkbox in the "Global properties" section.

WINS server

Set this option to the IP address of a WINS server that will be used by the Jenkins master, and will be the default for all other nodes (slaves)

The WINS server can be set or overridden for individual nodes (slaves)
A "Publish Over CIFS" checkbox will appear under "Node Properties" in the configuration for a node.
Set the WINS server to an IP address that this node will use for name resolution.
If a default WINS server has been specified in the "Global properties", a node can be configured to not use WINS by checking the "Publish Over CIFS" property and leaving the WINS server empty.

Create host configurations in the main Jenkins configuration

From the Jenkins home page, click "Manage Jenkins" and the click on "Configure System"

Find the CIFS section (as below) and click on the "Add" button next to "CIFS Servers"

You should now have the configuration options as below

Fill in Name, Hostname, Username, Password and Share. see Publish Over ... for common options for Host Configurations

Hostname

Hostname is the hostname, IP address or windows servername of the host that contains the share

Username

To specify a user in a specific windows domain, use a back slash to separate eg MYDOMAIN\myuser

Share

The share is equivalent to the standard Remote directory option, except that the Share is required and there is no concept of the directories being relative.
The share must be, or begin with, a windows share name on the server named in Hostname.

Advanced

If you click the "Advanced..." button for a configuration, then you will make more configuration options available (see below)

see Publish Over ... for common options for Host Configurations

Click "Test Configuration".
Add more server configurations (if required)
Save

Send files to a windows share during a build

This plugin adds a build step to enable you to send files to a windows share during a build.

Select "Send files to a windows share" from the "Add build step" drop down (pic below) and then configure just like Configure a job to send files to a windows share below

Configure a job to send files to a windows share

Open a jobs main page and then click "Configure" from the left hand menu.

Find the "Send build artifacts to a windows share" checkbox in the "Post-build Actions" section and click in the box.

You should now have the configuration options as below

see Publish Over ... for common options for Server

see Publish Over ... for common options for Transfer Sets

Source files
The build will fail if you do not select any Source files to transfer
Advanced (Transfer Sets)

If you click the "Advanced..." button for a Transfer Set, then you will make more configuration options available (see below)

see Publish Over ... for common options for Transfer Sets

Clean remote

Delete all files and directories from the remote directory before uploading the new files.

Advanced (Publisher)

If you click the "Advanced..." button that is immediately below the "Add Server" button, then you will make more configuration options available (see below)

see Publish Over ... for common options for Publisher

Options to override the default Promotion behaviour

If you are configuring an action in a promotion, new options will become available.

see Publish Over ... for common options for Promotions

Change log

@TODO not yet released

  • Initial release
Questions, Comments, Bugs and Feature Requests
Please post questions or comments about this plugin to the Jenkins User mailing list.
To report a bug or request an enhancement to this plugin please create a ticket in JIRA.

Labels

Edit
plugin-upload plugin-upload Delete
publish-over publish-over Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment