Story #3716
closedAs a production Pulp user, I have an Ansible installer
100%
Description
Motivation¶
1. Installation of Pulp is complicated and could be made much easier with an Ansible installer.
2. Clustered based installs are also very complicated. Typically users want to install some mixture of Pulp services on different hosts. Doing this consistently is time consuming and error prone. Ansible could install in clusered environments very well.
Usage¶
The installer will live as a collection of roles published via the 'pulp' user on Ansible Galaxy. That will cause it to be available here Each role will install a pulp component, and using an Ansible playbook the user can select which roles will run on any given host or host group. Here are the roles we foresee:
- pulp3 - install the pulp virtualenv and any plugins
- webserver - depends on pulp3. Installs the webserver of choice. Install systemd unit file for webserver. Set to autostart.
- resource manager - depends on pulp3. Installs resource manager systemd unit file. Set to autostart
- workers - depends on pulp3. Installs workers systemd unit files. Set to autostart
- Redis - hopefully an existing Role on Galaxy named in our playbooks as a dependency
- Postgres - hopefully an existing Role on Galaxy named in our playbooks as a dependency
Features¶
- Generic plugin installation as specified by Ansible variables. Any plugin that only requires a pip install command and the migrations run will work
- Install and configure Redis on a specific host in the inventory.
- Install and configure Postgres on a specific host in the inventory.
- Installs the virtualenv to be used in a role.
- Can optionally install to the system packages without a virtualenv
- Installs systemd units for a webserver, workers, or resource manager on one or more host in the inventory
- Allows a choice of Nginx or Apache (defaults to nginx)
- Allows for custom settings.py file provided by the user
- Provides sparse settings.py by default
- Idempotent
Assumptions¶
Dependency¶
This assumes that the installing the plugin will bring all of it's necessary dependencies including pulpcore.plugin and pulpcore itself. Specifically plugins are recommended to depend on pulpcore.plugin. That would bring in dependencies as follows:
Using Ansible variables, the Ansible installer will pip install pulp_ansible
for example which will cause the installation of these packages: pulp_ansible ---> pulpcore.plugin ----> pulpcore ----> pulpcore.common
Storage¶
In multi-host environments Pulp has a shared storage requirement. The Ansible playbook does not automatically set these up. It assumes that shared storage is already setup correctly.
Root Access¶
At a few points in the playbook, root is required so it's assumed that the user the playbook will access has root access. Specifically root is required for the following:
- To install Redis, Postgres, and the webserver, you'll need root
- By default, the virtualenv will be created at
/usr/local/pulpenv
which typically requires root to write into - In the case that virtualenv is unset, it will install Python code to the system packages which also will require root
- To create a user to run Pulp as will require root
Updated by Ichimonji10 about 6 years ago
Quite a bit of development work effort has been put into solving this issue. From where we currently stand, I think the next steps for the installer are as follows:
- Polish the existing code.
- Merge existing PRs.
- Merge the roles-dev branch back into the master branch. This ensures that the state of development is more obvious to people who don't have context with how development currently works on the roles-dev branch.
- Fix install locations! For example: place pulp's files in /usr/local/lib/pulp instead of /opt/pulp or /usr/lib/pulp.
- Normalize variable names and values. For example:
- Make all variables begin with "pulp_" (as opposed to e.g. "pulp3_")
- Make sure all roles have the same variable names.
- Make sure all roles have the same default values set. Use unit tests?
- Update all READMEs.
- Discover whether installer installs from PyPI or from source right now. If there are any discrepancies, settle on just one strategy.
- Make sure the "pulp" user is a system user, not a regular user.
- Create a Jenkins job that installs Pulp 3 on RHEL 7.
- This is important because we want to make our sponsor happy.
- This is important because the container images can be different from bare-metal/VM OS installations.
- Make installer capable of installing from PyPI or from source.
- Create a role that can install an arbitrary plugin, or many arbitrary plugins.
- Release somehow.
- Make a git repository available?
- Publish to galaxy via a monolithic repository?
- Publish to galaxy via independent repositories?
Updated by bmbouter over 4 years ago
- Category set to Installer - Moved to GitHub issues
- Tags deleted (
Pulp 3 installer)
Updated by daviddavis almost 4 years ago
- Status changed from NEW to CLOSED - CURRENTRELEASE