Plugins » Katello

h1. Pulp 3 Integration

This page is meant to capture links to various resources around pulp3 integration

* Initial Integration Document: https://docs.google.com/document/d/1eFM4H9BteA_nTDbUkRJgEiqSttXfAtB9-51a_OuwVJw/edit?usp=sharing

* Initial Community Post: https://community.theforeman.org/t/pulp-3-migration/10474

* Youtube Videos: https://www.youtube.com/playlist?list=PL59WSIBtIpv7tbjnsEAWNcdiOKAmjjgqE

* Tasks List: https://docs.google.com/spreadsheets/d/1PFx-VAEXlivlqDYR9INMW26AUWtuMS_XtEnwhFVP5Rc/edit?usp=sharing

* Main Tracker: https://projects.theforeman.org/issues/26987

h2. Katello Dev environment with pulp 3

* Install a katello dev environment with forklift

* checkout this katello PR into your katello checkout its not merged:  https://github.com/Katello/katello/pull/8150

* checkout this forklift pr if its not merged: https://github.com/theforeman/forklift/pull/980

* setup ansible-pulp:

<pre>

cd forklift

git clone https://github.com/pulp/ansible-pulp.git

cd ansible-pulp

ansible-galaxy install -r requirements.yml -p ./roles

</pre>

* within forkflift run:

<pre>

ansible-playbook ./playbooks/katello_pulp3.yml -l centos7-katello-devel

</pre>

* if this issue is not resolved https://projects.theforeman.org/issues/27014, then:

  1. login to katello/foreman

  2. navigate to infrastructure > smart proxies

  3. switch to 'any organization'

  4. switch to 'any location'

  5. A smart proxy should appear

  6. click edit on the drop down to the smart prxoy

  7. associate the smart proxy to the default org and location

* Refresh the smart proxy: 

  1. login to katello/foreman

  2. navigate to infrastructure > smart proxies

  3. click 'refresh' in the list of actions beside your smart proxy

You're now rockin' Pulp3

* Candlepin change (subject to installer updates)

You might encounter a  <pre>Katello::Resources::Candlepin::Owner: 404 Not Found  (GET /candlepin/owners/Default_Organization)</pre> after installing. This is because the ansible-playbook overwrites the pg_hba.conf. To fix it

<pre>

$ tee /var/lib/pgsql/data/pg_hba.conf << END

local all postgres    peer 

local all all    peer 

host all all 127.0.0.1/32   trust 

host all all ::1/128   trust

END

$ systemctl restart postgresql.service

</pre>

h3. Other Resources

* pulp3 gap analysis wiki https://projects.theforeman.org/projects/katello/wiki/PulpV3GapAnalysis

* pulp3 gap analysis etherpad https://etherpad.net/p/pulp3_container

* pulp3 docker roadmap https://pulp.plan.io/projects/pulp/wiki/Pulp_Docker_Roadmap

h3. Old way to deploy pulp3 on other box

* <pre>yum install vagrant-sshfs</pre>

* Checkout pulplift: https://github.com/pulp/pulplift 

* Follow pulplift readme instructions, copy the centos7-pulp3-github box definition from vagrant/boxes.d/99-local.yaml.example 

* vagrant up centos7-pulp3-github

* On katello dev env, edit /etc/foreman-proxy/settings.d/pulp3.yml    

** add/edit options (replacing dev.pulp3 with ip address or hostname of pulplift box):

<pre>

:enabled: true

:pulp_url: http://dev.pulp3/pulp/

</pre> 

* restart foreman-proxy:  systemctl restart foreman-proxy

* refresh your smart proxy, from the Infrastructure > Smart Proxies page

* Confirm that you see 'pulp3' show up in the list of features for that smart proxy