build_setup.md

# `Setting up chroot`

For building packages on jenkins , we use `debian stretch` chroot.

**Steps for setting up chroot using `schroot`**
=


## 1. Installing required packages

```
# apt-get install debootstrap schroot
```

## 2. Create chroot

Create new empty directory in /srv
```
# mkdir /srv/stretch-amd64
```

Now, debootrap the system where `testing` is the distribution name

```
# debootstrap --arch=amd64 testing stretch-amd64/ http://ftp.us.debian.org/debian
```

## 3. Updating schroot.conf

Open `/etc/schroot/schroot.conf` to add entry of newly created chroot

```
# nano /etc/schroot/schroot.conf
```

Add following lines to the file
```
[stretch-amd64]
description=debian stretch 64 bit
type=directory
directory=/srv/stretch-amd64
groups=sbuild-security
users=jenkins
root-groups=jenkins,root
```
Save and close the file.

## 4. Running schroot
To list available schroot
```
$ schroot -l
```
To run schroot as `root` user
```
# schroot -c stretch-amd64 -u root
```

**Steps for setting up  chroot using `pbuilder`**
=

## 1. Installing required packages
```
# sudo apt-get install pbuilder pdebuild
```

## 2. Creating chroot

Following command creates debian stretch amd64 chroot 
```
# sudo pbuilder --create --distribution testing --architecture amd64 --basetgz /var/cache/pbuilder/stretch-amd64 --mirror http://ftp.uk.debian.org/debian
```

## 3. Running pbuilder chroot
```
# sudo pbuilder --login --basetgz /var/cache/pbuilder/stretch-amd64 
```