https://github.com/microserve-io/puppet-docksal
Deploy and configure the Docksal development environment.
https://github.com/microserve-io/puppet-docksal
development-environment development-tools drupal puppet puppet-module
Last synced: 11 months ago
JSON representation
Deploy and configure the Docksal development environment.
- Host: GitHub
- URL: https://github.com/microserve-io/puppet-docksal
- Owner: microserve-io
- License: mit
- Created: 2019-02-20T16:45:39.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-04-01T10:12:42.000Z (almost 6 years ago)
- Last Synced: 2025-04-20T18:03:39.028Z (11 months ago)
- Topics: development-environment, development-tools, drupal, puppet, puppet-module
- Language: Ruby
- Homepage: https://microserve.io
- Size: 67.4 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/microserve-io/puppet-docksal)
# docksal
#### Table of Contents
1. [Description](#description)
2. [Setup - The basics of getting started with docksal](#setup)
* [What docksal affects](#what-docksal-affects)
* [Setup requirements](#setup-requirements)
* [Beginning with docksal](#beginning-with-docksal)
3. [Usage - Configuration options and additional functionality](#usage)
4. [Limitations - OS compatibility, etc.](#limitations)
5. [Development - Guide for contributing to the module](#development)
## Description
Installs and configures the docksal (github.com/docksal/docksal) program both for use by individual developers and in the 'CI' configuration. Does not manage configurations.
## Setup
### What docksal affects
Installs the fin cli to /usr/local/fin so that any user can execute it. Also creates user-specific config files in /.docksal/docksal.env and assumes full control over that file.
### Setup Requirements
Requires docker installed. For Mac requires docker installed either natively, or virtualbox installed.
### Beginning with docksal
Installing docksal globally is as simple as `include docksal`. Doing this will *not* affect individual user configuration files.
## Usage
### Install and configure docksal for the user `demo`
Install docksal globally and take control over the demo user's configuration file. This will control the file `/home/demo/.docksal/docksal.env` and install the default configuration options.
```puppet
include docksal
docksal::config { 'demo': }
```
### Install and configure docksal for a non-default home path
Although we assume that the home path of the user is `/home/`, this is not applicable to mac nor to all users. If you need to override this value, it is as simple as:
```puppet
include docksal
docksal::config { 'root':
home_directory => '/root'
}
```
### Install and configure with the CI variable set
Docksal CI mode is useful when you want to have CI server managed development environments. You can create the config for that by using:
```puppet
include docksal
docksal::config { 'ci_user':
home_directory => '/var/ci_runner',
ci => true
}
```
### Adding custom environment variables
To add custom environment variables to the `docksal.env` files managed by puppet, you can pass in the `env` parameter. For example:
```puppet
include docksal
docksal::config { 'ci_user':
home_directory => '/var/ci_runner',
env => {
HOSTING_ENVIRONMENT => 'qa'
}
}
```
## Limitations
* User home directory default doesn't ever work for macos