Project

General

Profile

Pulp 3 Integration » History » Revision 48

Revision 47 (Samir Jha, 03/09/2020 03:24 PM) → Revision 48/86 (Samir Jha, 03/09/2020 03:32 PM)

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 box with pulp3: 

 * vagrant up katello-dev-box 
 * vagrant ssh katello-dev-box 


 h2. Adding the yum plugin: 
 <pre> 
 sudo yum install -y gcc make cmake bzip2-devel expat-devel file-devel glib2-devel libcurl-devel libmodulemd2-devel ninja-build libxml2-devel python36-devel python36-gobject rpm-devel openssl-devel sqlite-devel xz-devel zchunk-devel zlib-devel 
 sudo pip3 install scikit-build nose 
 sudo pip3 install pulp-rpm==3.0.0 
 sudo -u pulp PULP_SETTINGS='/etc/pulp/settings.py' DJANGO_SETTINGS_MODULE='pulpcore.app.settings' python3-django-admin migrate --no-input 
 sudo systemctl restart pulpcore-resource-manager pulpcore-content pulpcore-api pulpcore-worker@1 pulpcore-worker@2 
 </pre> 

 * Refresh the smart proxy  
 # login to katello/foreman 
 # navigate to infrastructure > smart proxies 
 # click 'refresh' in the list of actions beside your smart proxy 

 You should now see file, docker and yum as supported content type under pulpcore in the *Services tab* 

 h2. Katello Dev box with pulp3 on master: 

 On a devel box provisioned with steps above, run : 

 <pre> 
 cd /usr/lib/python3.6/site-packages/ 
 sudo pip3 install "git+https://github.com/pulp/pulpcore.git" 
 sudo pip3 install scikit-build nose 
 sudo yum install -y gcc make cmake bzip2-devel expat-devel file-devel glib2-devel libcurl-devel libmodulemd2-devel ninja-build libxml2-devel python36-devel python36-gobject rpm-devel openssl-devel sqlite-devel xz-devel zchunk-devel zlib-devel 
 sudo pip3 install "git+https://github.com/pulp/pulp_file.git" 
 sudo pip3 install "git+https://github.com/pulp/pulp_rpm.git" 
 sudo pip3 install "git+https://github.com/pulp/pulp_container.git" 
 sudo pip3 install "git+https://github.com/pulp/pulp-2to3-migration.git" 
 sudo rm -rf pulpcore* 
 sudo rm -rf pulp_* 
 sudo rm -rf redis* 
 sudo mv /usr/local/lib/python3.6/site-packages/pulp* /usr/lib/python3.6/site-packages/ 
 sudo mv /usr/local/lib/python3.6/site-packages/redis* /usr/lib/python3.6/site-packages/ 
 cd ~/foreman 
 bundle exec rails katello:reset 
 </pre> 


 Add the following to your /etc/pulp/settings.py 

 <pre> 
 AUTHENTICATION_BACKENDS = ['pulpcore.app.authentication.PulpNoCreateRemoteUserBackend'] 

 REST_FRAMEWORK__DEFAULT_AUTHENTICATION_CLASSES = ( 
     'rest_framework.authentication.SessionAuthentication', 
     'pulpcore.app.authentication.PulpRemoteUserAuthentication' 
 ) 

 </pre> 




 

 h2. Old (ansible-based) way to deploy pulp3: 

 * Install a katello dev environment with forklift 
 * Install the following packages in your dev box:  
 <pre>sudo yum -y install https://people.redhat.com/iballou/libcomps-0.1.12-1.git.0.937a666.el7.x86_64.rpm</pre> 
 <pre>sudo yum -y install https://people.redhat.com/iballou/python3-libcomps-0.1.12-1.git.0.937a666.el7.x86_64.rpm</pre> 
 * 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 
 ansible-galaxy install pulp.pulp_rpm_prerequisites -p ./roles 
 </pre> 


 * within forkflift run: 
 <pre> 
 ansible-playbook ./playbooks/katello_pulp3.yml -l centos7-katello-devel 
 </pre> 

 * 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 


 * *Known Issue:* Can't seem to use pulp3 on the box since pulp-api.service fails to start. 
 <pre> 
 sudo chmod -R 777 /etc/pki/pulp/ 
 sudo systemctl restart pulpcore-api.service 
 </pre> 

 * Reset the Katello Pulp 3 Dev Environment 
 From within the Foreman directory: 
 <pre>bundle exec rake katello:reset</pre> 

 h2. Smart Proxy Setup: 

 * Install a smart proxy to point to your pulp3_dev box 
 * ssh into the smart proxy 
 * sudo mkdir /etc/httpd/conf.d/05-foreman-ssl.d 
 * sudo vi /etc/httpd/conf/httpd.conf 
 * Add IncludeOptional "/etc/httpd/conf.d/05-foreman-ssl.d/*.conf to the end of the file and save 
 * In forklift > Run ansible-playbook ./playbooks/katello_pulp3.yml -l centos7-proxy-devel 

 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