Operations grimoire/Contribute

Environment setup

Use of WindRiver is recommended if you wish to get an environment already installed for your contributions.

Everywhere setup

This section cover topics needed both on our development servers or in your laptop.

Python dependencies

Create a virtual environment, then install dependencies from rOPS: requirements.txt:

   mkdir -m $HOME/dev/python/ops
   python3 -m venv $HOME/dev/python/ops
   source $HOME/dev/python/ops/bin/activate
   pip install -r requirements.txt

Datacube

If you're in the ops group, you'll need sometimes to deploy from branches. As our deployment server Complector doesn't have PHP installed (so no arc), you need to exchange branches through our datacube.

On WindRiver:

    git remote add datacube /datacube/git/operations.git

Anywhere else:

    git remote add datacube ssh://windriver.nasqueron.org/datacube/git/operations.git

If you aren't in the ops groups, and have access to our devserver, you'll still be able to clone or pull from that directory, but not to write there (ie push branches).

Local computer setup

This section cover topics NOT needed on our development servers.

Arcanist

To use arc with the operations repository, our collection of patches is needed.

If arcanist isn't installed through Git repository, best is to do like on devserver role:

   mkdir /opt/phabricator && cd /opt/phabricator
   git clone https://github.com:nasqueron/arcanist.git
   git checkout production

If you've already cloned Arcanist repository, switch to our branch production:

   git remote add nasqueron git@github.com:nasqueron/arcanist.git
   git fetch --all
   git checkout production

As of August 2024, there is no plan to make that repository available on DevCentral.

See also

• How to contribute code
• Devserver reference