Home

jenkins-to-salesforce Wiki Page

We are assuming you have installed the docker image anyei/jenkins-to-salesforce.

How to setup integration between jenkins job and Github repository.

On Jenkins:

1. Go to your jenkins server, like this http://yourjenkinsserver:8080
2. Click on the job you want to configure git. If you dont have any, you may click on "New Item" link from the top left corner and then select the option "Freestyle project", of course you to type in a title for the job.
3. Click on "Configure" link from the left menu.
4. Go to the "Source Code Management" section and select "git" option.
5. In the Repository Url input, provide the source git repository, it should be something like this one git@github.com:anyei/jenkins-to-salesforce.git.
6. After putting the focus out of the input text, it will try to validate that repo, an error message may appear next to the input box for many reasons, we just ignore for now and keep moving.
7. Click the "Add" button from the "Credentials" field which will open the add credentials popup window.
8. In the add credentials popup window, select "SSH Username with private key" in the Kind field.
9. Leave Scope field as it is, and type in "jenkins" in the Username field.
10. In the private Key field, you may select "From the jenkins master ~/.ssh" option, which automatically get the key from the location /var/jenkins_home/.ssh/ and use it when authenticating against the target git repository.
11. Click save button in the popup.
12. Click save button to the bottom of the configuration page for the job.

Giving public key to Github:

1. Go to your github profile.
2. Go to settings
3. Go to SSH Keys
4. Click on "Add SSH Key" button.
5. Type in a title in the Title input, this is only a label to easy identify this entry.
6. In the Key field, paste the content of your jenkins public key located in your jenkins container in /var/jenkins_home/.ssh/id_rsa.pub.
7. Click "Add Key" green button to save the entry.

Alternate Method, giving public key to local repository:

If you dont want a github account, and you just have a regular folder with a git initialization (git init --bare), in the step 5 of the "On Jenkins" section in this page, you should provide the url of that server repository, it should look like this anyei@myserver.com:repo.git, then do:

1. Login to myserver.com.
2. If doesn't exists, create an authorized_keys file in this path ~/.ssh:

$ touch ~/.ssh/authorized_keys

3. Paste the content of your jenkins public key located in your container in /var/jenkins_home/.ssh/id_rsa.pub. Assuming your jenkins container's name is jenkins-sfdc Do:

$ docker exec -it jenkins-sfdc /bin/bash
$ cat ~/.ssh/id_rsa.pub | ssh anyei@myserver.com 'cat >> ~/.ssh/authorized_keys'

Now we have keys setup to in jenkins and in our repository, we just to go to our jenkins job and build!! (if you dont have the build.xml setup in your repository, read this article: Configuring Jenkins to Deploy to Salesforce with Migration Tools