cookbook 'codenamephp_workstation_php', '~> 2.4.0'
The codenamephp_workstation_php cookbook has been deprecated
Author provided reason for deprecation:
The codenamephp_workstation_php cookbook has been deprecated and is no longer being maintained by its authors. Use of the codenamephp_workstation_php cookbook is no longer recommended.
codenamephp_workstation_php (11) Versions 2.4.0 Follow0
Cookbook to install apache2
cookbook 'codenamephp_workstation_php', '~> 2.4.0', :supermarket
knife supermarket install codenamephp_workstation_php
knife supermarket download codenamephp_workstation_php
Chef Workstation PHP
Sets up a PHP workstation for PHP development with docker and PHPStorm.
Usage
Intended use is in a wrapper cookbook where you can either include the default recipe or just the recipe parts. You will have to create
users yourself.
What's included
The workstation is based on git and docker and also installs some other useful tools:
- Sets german keyboard layout, utf-8 de locale and timezone to Europe/Berlin
- Docker, Docker-Compose and Docker image using codenamephp/php.webdevops.php-dev
- Git
- Jetbrains Toolbox for easy PHPStorm install
- MS Edge as browser
Optional:
- Install gnome gui and set keyboard shortcuts
Attributes
-
default['users']
: This is used for a lot of different things, defaults to['php']
- If you include the optional users recipe these users will be created and added to the ühp group
- If the gnome recipe is included it is used to setup keyboard shortcuts
users_from_data_bag
Used in the optional users_from_data_bag recipe:
- default['codenamephp']['workstation_php']['users_from_data_bag']['data_bag_name']
: The name of the databag to get the users from, defaults to 'users'
- default['codenamephp']['workstation_php']['users_from_data_bag']['groups']
: The groups to find the users that will be managed. Defaults to %w(php docker sudo sysadmin)
users
Used in the optional users cookbook:
The recipe checks for a specific path within the attributes that corresponds to the values of default['users']
to copy ssh keys and manage git configs.
There is a default set for the default 'chef' user:
-
default['codenamephp']['workstation_php']['ssh_keys']['local_copy']['php']['private_key_source']
:'/var/workspace/id_rsa'
default['codenamephp']['workstation_php']['git_client']['php']['config'] = {}
Recipes
These are the recipes that are not included in the default recipe and can be used to "customize" the chef run.
The default recipe sets up everything else by including the recipes not listed here. Most notably, users and gui are optional.
Gnome
Installs the gnome desktop and sets serveral settings and keyboard shortcuts
Creating users
There are several ways to create users. These should be included before the default recipe so the users are already set up when the other tools are installed.
If you don't use one of those recipes make sure to create the users yourself since you might run into problems when the recipes try to setup tools that are bound to a user (like vscode)
Users
The users recipe is very very simple user setup. It just creates all users in the default['users']
attribute with a home directory and an empty password and add them to the chef group.
It checks for a specific path within the attributes that corresponds to the values of default['users']
to copy ssh keys.
There is a default set for the default 'php' user:
-
default['codenamephp']['workstation_php']['ssh_keys']['local_copy']['php']['private_key_source']
:'/var/workspace/id_rsa'
You can change this value or add additional attributes for additional users. If you need anything more sophisticated you should provide your own logic in a wrapper cookbook.
It also manages the git config for the set users. By default it's empty but you can set this the same way as attributes:
default['codenamephp']['workstation_php']['git_client']['php']['config'] = {}
Users From Data Bag
A more sophisticated method of creating users. It looks for a databag with the name in default['codenamephp']['workstation_php']['users_from_data_bag']['data_bag_name']
and adds all users that have one the groups from default['codenamephp']['workstation_php']['users_from_data_bag']['groups']
.
Note that the default['users']
attribute is still important since this is used to setup things like gnome keyboard shortcuts The databag is just for the
creation of the users so yous hould try to match them (for now).
Also any users according to the codenamephp_git_client_config_users_from_data_bag resource are managed as well.
Dependent cookbooks
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
2.4.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Cookstyle Metric
2.4.0 passed this metric
No Binaries Metric
2.4.0 passed this metric
Testing File Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.4.0 failed this metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Cookstyle Metric
2.4.0 passed this metric
No Binaries Metric
2.4.0 passed this metric
Testing File Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.4.0 passed this metric
2.4.0 passed this metric
Testing File Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.4.0 failed this metric
2.4.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number