---
# System prepended metadata

title: CAT (Content And Tooling) Onboarding Documents

---

# Onboarding Guide


**Ownership**
* [Tools](
https://puppetlabs.github.io/content-and-tooling-team/tools/)
* [Modules](https://puppetlabs.github.io/content-and-tooling-team/modules/)

**Documentation**
* https://hackmd.io/team/ppt-iac

**Access Request ([Request URL](https://perforce.atlassian.net/servicedesk/customer/portals))**
* [JIRA `CONT` Project](https://tickets.puppetlabs.com)
* Google Cloud's`IA-CONTENT` subscription
* GitHub (Please make sure you share your GitHub username while raising access request)
* Puppet VPN Tunnelblick (This will also gives access to https://confluence.puppetlabs.com)
* Get yourself added to Puppet Community slack and be part of channel `#office-hours`
* Check with Team-mate and request him/her to get yourlself added to Perforce Slack channels like `#puppet-india`, `#puppet-team-cat-human`, `#puppet-team-cat-triage`
* Also get added to Stand-up & Demo meetings
* Raise an IT request to be a part of puppet-indiateam@perforce.com DL
* Also get added to the modules and puppet organization group as well.You can raise request from github to join the modules group.


**Setup**
* Set up communications applications (Slack, Outlook, HackMD (Using GihHub account), Zoom, Outlook Calendar) 
* Set up tools (IDE (Sublime, Visual Studio Code, etc), Docker Desktop, Vagrant, etc)
* Set up accounts (GitHub, LinkedIn Learning, Zendesk)
* Setup ruby latest (3.2.2) and latest -1 (2.7.8) versions (using rvm or rbenv)
* Setup puppet Agent for setup VPN & initial stuff ([Doc](https://perforcesoftwareinc-my.sharepoint.com/personal/ramesh_sencha_perforce_com/_layouts/15/onedrive.aspx?login_hint=ramesh%2Esencha%40perforce%2Ecom&id=%2Fpersonal%2Framesh%5Fsencha%5Fperforce%5Fcom%2FDocuments%2FVPN%20Instructions%2Epdf&parent=%2Fpersonal%2Framesh%5Fsencha%5Fperforce%5Fcom%2FDocuments))
Use below puppet agent config to run the puppet agent on your local.
```
[main]
server="yoda.puppetlabs.com"
certname="<your-cert-name>"
environment="workstation_production"
runtimeout="10m"
```
For more details for on-boarding please refer following [document](https://perforcesoftwareinc-my.sharepoint.com/:w:/r/personal/lukas_audzevicius_perforce_com/_layouts/15/doc2.aspx?sourcedoc=%7B1CAD0144-76F9-FA63-C0A6-A72FE88B2650%7D&file=CAT%20Onboarding.docx&action=default&mobileredirect=true&cid=1789cb6e-d7f5-4e0c-bef1-890f290b91f8).

**CI Pipeline**
CAT Team mostly using GitHub actions for their CI and all the GitHub action config can be found [here](https://github.com/puppetlabs/cat-github-actions)
The GitHub actions underline using multiple components like Litmus, Bolt, Provisioning Service & etc. Below is architecture diagram of Provisioning workflow

![](https://hackmd.io/_uploads/rkSrLxO_2.png)

There is demo [recording](https://perforce.zoom.us/rec/play/B7LS_iaDGMZWkTqsPJhhwhmX3c4iK5piaPfiU0YqMjsktS2eB1y3fm7Z6y2IymPkWau-P6kS71hPqwJW.5DwyDNgXiWBSAwvp?autoplay=true&canPlayFromShare=true&componentName=rec-play&continueMode=true&from=share_recording_detail&originRequestUrl=https%3A%2F%2Fperforce.zoom.us%2Frec%2Fshare%2Fmav0atL1y6r0x7JmehwWKBtyAAGNOlMjIIqonaTSEmArcF_4E2Fo5BnOoypPIh1K.rQey3ToaNwvYgEFF&startTime=1686897294000) available with passcode `=X3#z+*h`
  **NOTE** Please start recording from 23rd minute for provisioning service.

**Testing Ref**
* [Debugging modules](https://perforce.zoom.us/rec/share/YLuZ60_GS_9DsaqMb2-TSmzOTALI-HmEYe9KyWMxp_axwwlmTY6W2n3IJOSH3QPG.GY4v6hJr77v-pBJ4) (Passcode `8FV8^m4f`)
* [Puppet 8 testing steps](https://hackmd.io/@ppt-iac/B1Z9s7kb3)
* [Provision Service](https://hackmd.io/acFpXgTGR1ysfE6jlTXRgw?view)
* [Litmus](https://github.com/puppetlabs/puppet_litmus/blob/main/docs/md/content/usage/testing/running-acceptance-tests.md)

**Informational Recordings**
These recordings covers up what is puppet, its architecture and different project streams.
* [Puppet Products overview](https://perforce.zoom.us/rec/share/1hntcY7IukNguzs65k0y9wEpYCwDVDR4k9sG_iOj4Q2VuBtx6-vFr28_zlPT2UEv.bDOrFbTxO6hCgigX) [**Passcode** %Jd^3iZK]
* [Puppet Enterprise Overview](https://perforce.zoom.us/rec/share/TEsMQuprRiq1rYt-SEfy3uR6JSSAI44QwnMj1vMrVCADfsKT2pBX2Y_3N1XIAowC.BvhVCJFFLQ0usHVh) [**Passcode** L!ryvL9H]
* [Puppet Comply walkthrough](https://perforce.zoom.us/rec/share/73rwIaBnHHXAXClsnrw0IfOGbcptUbDUclMw9i3uELibTFe7hDKa8pcO0fvjWomd.tb7zeiwhpBzVOqrB) [**Passcode** ^V.A4x@=)


**Puppet Enterprise courses (Training Materials)**
Enroll for 3 course by signing up on the platform PE101,PE201,PE301 respectively
* [Courses](https://training.puppet.com/learn/course) 


**Some Helpful commands**
```
bundle install
# pre requisit setup
bundle exec rake spec_prep
# run test parallel
bundle exec rake parallel_spec
# run test one by one (default)
bundle exec rspec spec

# Check linting & syntax check
bundle exec rake syntax lint metadata_lint check:symlinks check:git_ignore check:dot_underscore check:test_file rubocop

# litmus commands to provision VM/Container
bundle exec rake 'litmus:provision[provision_docker, litmusimage/ubuntu:20.04]
bundle exec rake 'litmus:install_agent[puppet7-nightly]'
bundle exec rake 'litmus:install_module'
TARGET_HOST=<hostname> bundle exec rspec spec/acceptance/<path of spec file>
```