~/install
Add the repository
1 — add repo source
# /etc/apt/sources.list.d/faaleoleo.list
deb [trusted=yes] https://YOUR-EMAIL:YOUR-TOKEN@portal.faaleoleo.io/deb ./
2 — update and install
apt-get update
apt-get install <package-name>
Sign in to get a preconfigured sources.list file with your credentials already filled in.
1 — add repo file
# /etc/yum.repos.d/faaleoleo.repo
[faaleoleo]
name=Faaleoleo Packages
baseurl=https://YOUR-EMAIL:YOUR-TOKEN@portal.faaleoleo.io/rpm
enabled=1
gpgcheck=0
2 — install a package
dnf install <package-name>
Sign in to get a preconfigured .repo file with your credentials already filled in.
example playbook
---
- hosts: all
vars:
fds_user: "YOUR-EMAIL"
fds_token: "YOUR-TOKEN" # keep this in Ansible Vault
tasks:
- name: Add Faaleoleo apt source (Debian/Ubuntu)
ansible.builtin.apt_repository:
repo: >-
deb [trusted=yes] https://{{ fds_user }}:{{ fds_token }}@portal.faaleoleo.io/deb ./
state: present
filename: faaleoleo
when: ansible_os_family == "Debian"
- name: Add Faaleoleo yum repo (RHEL/CentOS/Fedora)
ansible.builtin.yum_repository:
name: faaleoleo
description: Faaleoleo Packages
baseurl: "https://{{ fds_user }}:{{ fds_token }}@portal.faaleoleo.io/rpm"
enabled: yes
gpgcheck: no
when: ansible_os_family == "RedHat"
Sign in to download a vars file with your email pre-filled. Store your token in Ansible Vault.
1 — module class (puppet/modules/faaleoleo/manifests/repo.pp)
class faaleoleo::repo (
String $fds_user, # set via Hiera
String $fds_token, # set via Hiera / eyaml (encrypted)
) {
if $facts['os']['family'] == 'Debian' {
apt::source { 'faaleoleo':
location => "https://${fds_user}:${fds_token}@portal.faaleoleo.io/deb",
release => './',
repos => '',
trusted => true,
}
}
if $facts['os']['family'] == 'RedHat' {
yumrepo { 'faaleoleo':
descr => 'Faaleoleo Packages',
baseurl => "https://${fds_user}:${fds_token}@portal.faaleoleo.io/rpm",
enabled => 1,
gpgcheck => 0,
}
}
}
2 — hiera data (data/nodes/<hostname>.yaml)
faaleoleo::repo::fds_user: 'YOUR-EMAIL'
faaleoleo::repo::fds_token: ENC[PKCS7,...] # hiera-eyaml encrypted
Sign in to get your email pre-filled. Encrypt the token with eyaml encrypt -s YOUR-TOKEN.
1 — pillar (pillar/faaleoleo.sls)
faaleoleo:
user: 'YOUR-EMAIL'
token: 'YOUR-TOKEN' # use a vault pillar ext in production
2 — state (salt/states/faaleoleo/repo.sls)
# Debian / Ubuntu
faaleoleo_apt_source:
pkgrepo.managed:
- name: >-
deb [trusted=yes]
https://{{ pillar['faaleoleo']['user'] }}:{{ pillar['faaleoleo']['token'] }}@portal.faaleoleo.io/deb ./
- file: /etc/apt/sources.list.d/faaleoleo.list
- refresh_db: true
# RHEL / CentOS / Fedora
faaleoleo_yum_repo:
pkgrepo.managed:
- name: faaleoleo
- baseurl: "https://{{ pillar['faaleoleo']['user'] }}:{{ pillar['faaleoleo']['token'] }}@portal.faaleoleo.io/rpm"
- enabled: 1
- gpgcheck: 0
Sign in to get your email pre-filled. Store the token in a Salt pillar or vault ext-pillar.
Manual download
Sign in to download individual packages from the packages page and install them directly.
Debian / Ubuntu
dpkg -i package-name.deb
apt-get install -f # resolve dependencies if needed
RHEL / CentOS / Fedora
dnf install ./package-name.rpm
Tarball (any distro)
tar -xzf package-name.tar.gz