root
/
buildah
mirror of https://github.com/containers/buildah.git
1
0
Fork 0
Code Issues Actions 3 Packages Projects Releases Wiki Activity
buildah/install.md

121 lines
3.1 KiB
Markdown
Raw Normal View History

README: better first glance idea Fixes #347 Make the project's first-glance easier to digest. Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-12-05 05:31:23 +08:00
# Installation Instructions
Prior to installing Buildah, install the following packages on your linux distro:
* make
* golang (Requires version 1.8.1 or higher.)
* bats
* btrfs-progs-devel
* bzip2
* device-mapper-devel
* git
* go-md2man
* gpgme-devel
* glib2-devel
* libassuan-devel
* ostree-devel
* runc (Requires version 1.0 RC4 or higher.)
* skopeo-containers
add headings for different OSes Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 00:13:17 +08:00
## Fedora
README: better first glance idea Fixes #347 Make the project's first-glance easier to digest. Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-12-05 05:31:23 +08:00
In Fedora, you can use this command:
```
dnf -y install \
make \
golang \
bats \
btrfs-progs-devel \
device-mapper-devel \
glib2-devel \
gpgme-devel \
libassuan-devel \
ostree-devel \
git \
bzip2 \
go-md2man \
runc \
skopeo-containers
```
Then to install Buildah on Fedora follow the steps in this example:
```
mkdir ~/buildah
cd ~/buildah
export GOPATH=`pwd`
git clone https://github.com/projectatomic/buildah ./src/github.com/projectatomic/buildah
cd ./src/github.com/projectatomic/buildah
make
run make install as sudo Explicitly using `sudo` in the `make install` line makes it clear that the rest of the commands can (and probably should) be ran as non-root. Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 00:22:17 +08:00
sudo make install
README: better first glance idea Fixes #347 Make the project's first-glance easier to digest. Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-12-05 05:31:23 +08:00
buildah --help
```
add headings for different OSes Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 00:13:17 +08:00
## RHEL, CentOS
In RHEL and CentOS 7, ensure that you are subscribed to `rhel-7-server-rpms`,
README: better first glance idea Fixes #347 Make the project's first-glance easier to digest. Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-12-05 05:31:23 +08:00
`rhel-7-server-extras-rpms`, and `rhel-7-server-optional-rpms`, then
run this command:
```
yum -y install \
make \
golang \
bats \
btrfs-progs-devel \
device-mapper-devel \
glib2-devel \
gpgme-devel \
libassuan-devel \
ostree-devel \
git \
bzip2 \
go-md2man \
runc \
skopeo-containers
```
add headings for different OSes Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 00:13:17 +08:00
The build steps for Buildah on RHEL or CentOS are the same as Fedora, above.
## Ubuntu
README: better first glance idea Fixes #347 Make the project's first-glance easier to digest. Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-12-05 05:31:23 +08:00
In Ubuntu zesty and xenial, you can use this command:
```
apt-get -y install software-properties-common
add-apt-repository -y ppa:alexlarsson/flatpak
add-apt-repository -y ppa:gophers/archive
apt-add-repository -y ppa:projectatomic/ppa
apt-get -y -qq update
apt-get -y install bats btrfs-tools git libapparmor-dev libdevmapper-dev libglib2.0-dev libgpgme11-dev libostree-dev libseccomp-dev libselinux1-dev skopeo-containers go-md2man
apt-get -y install golang-1.8
```
Then to install Buildah on Ubuntu follow the steps in this example:
```
mkdir ~/buildah
cd ~/buildah
export GOPATH=`pwd`
git clone https://github.com/projectatomic/buildah ./src/github.com/projectatomic/buildah
cd ./src/github.com/projectatomic/buildah
PATH=/usr/lib/go-1.8/bin:$PATH make runc all TAGS="apparmor seccomp"
add install.runc target We need this for platforms like Ubuntu and Debian that do not ship a standard (post 1.0rc4) version of runc. I'm assuming here this is why we're building `runc` on our own here - but it doesn't make sense to just do that while leaving only a symlink in $PWD. We want to actually install the thing as well. So we add an `install.runc` target, similar to `install.libseccomp.sudo` to make sure we install `runc` in the right location. An alternative to this would be to change the documentation to do the `install` command by hand, but this is more error-prone. As runc trickles down to the Debian distros, we can then just remove the `make install.runc` call and, eventually, the target itself. Closes: #355 Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 02:25:42 +08:00
sudo make install install.runc
README: better first glance idea Fixes #347 Make the project's first-glance easier to digest. Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-12-05 05:31:23 +08:00
buildah --help
```
add Debian stable install instructions Note that the instructions may seem unusual to people used to `apt-key`, but they conform to the [emerging standard](https://wiki.debian.org/DebianRepository/UseThirdParty) for third-party repositories in Debian. We use ostree from backports because it matches the version in the Ubuntu Flatpak PPA. We also explicitly require golang 1.8, which gives us a 1.8.1 runtime in stretch. We otherwise use the Project Atomic, but that's only because of Skopeo and similar tools. Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 00:20:47 +08:00
## Debian
To install the required dependencies, you can use those commands, tested under Debian GNU/Linux amd64 9.3 (stretch):
```
gpg --recv-keys 0x018BA5AD9DF57A4448F0E6CF8BECF1637AD8C79D
gpg --export 0x018BA5AD9DF57A4448F0E6CF8BECF1637AD8C79D >> /usr/share/keyrings/projectatomic-ppa.gpg
echo 'deb [signed-by=/usr/share/keyrings/projectatomic-ppa.gpg] http://ppa.launchpad.net/projectatomic/ppa/ubuntu zesty main' > /etc/apt/sources.list.d/projectatomic-ppa.list
apt update
install golang metapackage from backports `golang-1.8` *is* available in stretch, but /usr/bin/go does *not* point to it by default, *unless* the `golang` meta-package is installed from backports. Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 03:26:34 +08:00
apt -y install -t stretch-backports libostree-dev golang
apt -y install bats btrfs-tools git libapparmor-dev libdevmapper-dev libglib2.0-dev libgpgme11-dev libseccomp-dev libselinux1-dev skopeo-containers go-md2man
add Debian stable install instructions Note that the instructions may seem unusual to people used to `apt-key`, but they conform to the [emerging standard](https://wiki.debian.org/DebianRepository/UseThirdParty) for third-party repositories in Debian. We use ostree from backports because it matches the version in the Ubuntu Flatpak PPA. We also explicitly require golang 1.8, which gives us a 1.8.1 runtime in stretch. We otherwise use the Project Atomic, but that's only because of Skopeo and similar tools. Signed-off-by: Antoine Beaupré <anarcat@debian.org> Closes: #354 Approved by: rhatdan
2017-12-12 00:20:47 +08:00
```
The build steps on Debian are otherwise the same as Ubuntu, above.