Files
gitea-pages/admin-guide/puppet/development.md

41 lines
1.8 KiB
Markdown

# Development Environments
Beside the __prod__ and __preprod__ environments also development environments can be deployed on the puppet server. To create a new test environment simply:
1. Clone the puppet repository https://git.psi.ch/linux-infra/puppet
2. Create a new branch with a name that matches following regex: `^[a-z]+[a-z,0-9,_]+$` (e.g. my_test_branch)
3. Do and commit your changes
4. Push the new branch / changes to the git server
Whenever the git server receives a push a gitlab-runner gets triggered on the puppet server that does the automatic checkout of the branch and registers this as a new development environment.
Note: If branches are deleted on the git server the corresponding checkouts/environments on the puppet server will also be removed.
To use/test the code changes via the puppet test environment use
```
puppet agent -t --environment=issue_x
```
Continue the commit / push / test cycle until your changes are working. Afterwards create a merge request for the branch to the __preprod__ branch.
<video controls width="100%" src="../../_static/videos/dev_environments.m4v">video</video>
## Development Environment Names
The name of an branch/environment must match the following regex expression: `^[a-z]+[a-z,0-9,_]+$`
If the name is not compliant with this rule, a push of the branch to the git server will not be possible.
# Attach Node to Different Puppet Server
For testing purpose you might change the Puppet server to which a test node is attached to. To do so do, change the ``server`` in the ``[main]`` section of ``/etc/puppetlabs/puppet/puppet.conf`` accordingly.
Then delete the current host and CA certficate and the CRL:
#. ``rm /etc/puppetlabs/puppet/ssl/certs/*``
#. ``rm /etc/puppetlabs/puppet/ssl/crl.pem``
Finally run the puppet agent again.