Rocinante

Rocinante is lightweight configuration management software by the same team that brought you BastilleBSD.

Definition

Rocinante noun | \ ˌrä-zə-ˈnän-tē \ Spanish pronunciation: [roθiˈnante] (Castilian) | [rosiˈnante] (Latin American)

1. Literary. The worn-out and gaunt but spirited horse of Don Quixote in Miguel de Cervantes’ novel Don Quixote (1605/1615). Often used symbolically to represent noble but impractical idealism or outdated grandeur.

2. Figurative. Any outdated or underpowered vehicle, system, or companion elevated by its purpose or mission despite its humble nature.

Etymology: From Spanish Rocinante, a combination of rocín (“workhorse” or “nag”) and antes (“before” or “formerly”), suggesting a transformation from a common plow horse to a noble steed.

Rocinante on FreeBSD

This document is designed to help you be successful in your use and adoption of Rocinante and FreeBSD. This document begins with a brand-new FreeBSD 14.3 system deployed locally or in the cloud. Manual installation is not covered in this document.

Install Rocinante

PKG

pkg install rocinante

PORTS

portsnap fetch auto
make -C /usr/ports/sysutils/rocinante install clean

GIT(bleeding edge/unstable)

git clone https://github.com/BastilleBSD/rocinante.git
cd rocinante
make install

bootstrap

rocinante bootstrap https://github.com/cedwards/freebsd-install

cmd

cmd: Execute arbitrary command(s).

rocinante cmd fetch https://git.io/antigen -o /usr/local/share/zsh/antigen.zsh

cp

cp: Copy files from source to destination. See cp(8).

rocinante cp

limits

limits: Apply resource limits. See rctl(8).

rocinante limits ...

list

list: List bootstrapped templates.

rocinante list

pkg

pkg: Manipulate binary packages. See pkg(8).

rocinante pkg install nginx

service

service: Manage services. See service(8).

rocinante service sshd start

sysctl

sysctl: Manage sysctl values. See sysctl(8).

rocinante sysctl kern.randompid=1

sysrc

sysrc: Safely edit rc files. See syscrc(8).

rocinante sysrc sshd_enable=YES

template

template: Apply templates.

rocinante template template/path

update

update: Update release to latest -pX. See freebsd-update(8).

rocinante update ...

upgrade

upgrade: Upgrade release to X.Y-RELEASE. See freebsd-update(8).

rocinante upgrade ...

verify

verify: Compare release against a “known good” index.

rocinante verify ...

zfs

zfs: Manage (get|set) ZFS attributes on targeted container(s).

rocinante zfs ...

usage

Rocinate is lightweight configuration management software for FreeBSD.

Usage:
  rocinante command [args]

Available Commands:
  bootstrap   Bootstrap an automation template from an http(s) endpoint.
  cmd         Execute arbitrary command(s).
  cp          Copy files from source to destination. See cp(8).
  help        Display this usage information.
  limits      Apply resource limits. See rctl(8).
  list        List bootstrapped templates.
  pkg         Manipulate binary packages. See pkg(8).
  service     Manage services. See service(8).
  sysctl      Manage sysctl values. See sysctl(8).
  sysrc       Safely edit rc files. See syscrc(8).
  template    Apply templates.
  update      Update release to latest -pX. See freebsd-update(8).
  upgrade     Upgrade release to X.Y-RELEASE. See freebsd-update(8).
  verify      Compare release against a "known good" index.
  zfs         Manage (get|set) ZFS attributes on targeted container(s).

Use "rocinante -v|--version" for version information.
Use "rocinante command -h|--help" for more information about a command.

To learn more about automating FreeBSD configuration, see the Rocinante Documentation.