https://github.com/ottenwbe/developer-environment-setup
Ansible playbook to setup Linux developer machines.
https://github.com/ottenwbe/developer-environment-setup
ansible playbook
Last synced: 4 months ago
JSON representation
Ansible playbook to setup Linux developer machines.
- Host: GitHub
- URL: https://github.com/ottenwbe/developer-environment-setup
- Owner: ottenwbe
- License: mit
- Created: 2016-12-04T18:14:24.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2026-01-27T21:10:53.000Z (5 months ago)
- Last Synced: 2026-01-28T08:57:42.196Z (5 months ago)
- Topics: ansible, playbook
- Language: Jinja
- Homepage:
- Size: 53.7 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# developer-environment-setup
[](https://github.com/ottenwbe/developer-environment-setup/actions/workflows/main.yml)
This ansible playbook is used by me to automate the setup of my Linux developer machines.
If you frequently reinstall your system, you know why these scripts were created.
Therefore, this repository will be updated whenever I setup a new machine (commits to master).
## Supported Linux Distributions
Right now the only tested Distributions are:
* Fedora 43
## Structure
```
.
├── bootstrap_local.sh // Script to bootstrap the ansible environment before executing the playbook
├── site.yml // Playbook that wraps all tasks, roles, ...
├── ...
├── roles/ // Roles to be executed by the playbook
│ ├── common // Installation of common tools, external repos (rpm-fusion...), etc.
│ ├── user // Creation of users
│ ├── zsh // Installation of zsh for each user
│ ├── vscode // Installation of Visual Studio Code
│ ├── ansible // Installation of Ansible and linting tools
│ ├── cpp // Everything needed for C(pp) development
│ ├── go // Everything needed for Golang development
│ ├── java // Everything needed for Java development
│ ├── kubernetes // Everything needed for Kubernetes development (minikube, helm, ...)
│ ├── python // Everything needed for Python development
│ └── ruby // Everything needed for Ruby development
│ ├── virtualization // Virtualization tools (VirtualBox, Vagrant)
│ └── intellij // Installation of IntelliJ IDEA
│ └── ai // AI tools (Ollama, PyTorch, Jupyter)
└── test/ // Test the playbook in docker images
└── docker/
```
## Usage
First of all, clone this repository.
```
git clone https://github.com/ottenwbe/developer-environment-setup.git
```
The ```bootstrap_local.sh``` script installs ansible as a prerequisite for executing the playbook.
On a local Fedora installation where ansible is __not__ (yet) installed the playbook can be executed as follows. The playbook will install ansible and start sshd:
```bash
sh bootstrap_local.sh inventory.yml @vars.json
```
This expects a simple config, vars.json, like this to setup your users and all configurations in their respective home directories:
```json
{
"users": [
{
"username": "user1",
},
{
"username": "user2",
}
]
}
```
On a local Linux installation where ansible is installed the playbook can be executed as follows. NOTE: in this example the [git config](https://git-scm.com/docs/git-config) is updated as well for the user, which is an optional step:
```bash
ansible-playbook -i inventory.yml site.yml --connection=local --extra-vars '{"users": [{"username": "your user", "git_name": "Your Name", "git_email": "email@example.com"}]}' --ask-become-pass
```
## Tags
The playbook uses tags to allow running specific parts of the setup.
Available tags:
* system: Runs all system setup roles (user, zsh, vscode, ansible, common)
* dev: Runs all development environment roles (go, java, ruby, cpp, python, kubernetes, virtualization)
* user: User creation and configuration
* zsh: ZSH shell setup
* vscode: Visual Studio Code installation
* ansible: Ansible installation
* common: Common tools and repositories
* go: Go development environment
* java: Java development environment
* ruby: Ruby development environment
* cpp: C++ development environment
* python: Python development environment
* kubernetes: Kubernetes tools (Minikube, Helm, etc.)
* virtualization: Virtualization tools (VirtualBox, Vagrant)
* intellij: IntelliJ IDEA installation
To run only specific tags:
```bash
ansible-playbook -i inventory.yml site.yml ... --tags "tag1,tag2"
```
Or using the bootstrap script (4th argument):
```bash
sh bootstrap_local.sh inventory.yml Fedora "tag1,tag2" true
```
## Configuration
You can customize the installation by overriding default variables using --extra-vars.
For example, if you have the need to install IntelliJ IDEA Ultimate instead of the default Community edition:
```bash
ansible-playbook ... --extra-vars '{"intellij_edition": "ultimate"}'
```
## Testing
The playbook can be tested in a Docker container---more or less.
### Docker
__NOTE__: On an SELinux, i.e., Fedora, first execute the following command in the root directory of the project.
```bash
chcon -Rt svirt_sandbox_file_t "${PWD}"
```
On a non SELinux you can simply build a docker image and execute the playbook in a container. Replace one of the 'testuser's' with a username that suits you and run the following commands:
```bash
docker build --file=test/docker/Dockerfile.fedora --build-arg "FEDORA_VERSION=43" --tag=fedora43:ansible test/docker
docker run --name=test-fedora --rm --volume="${PWD}":/home/ansible:ro fedora43:ansible ansible-playbook -i /home/ansible/test/docker/inventory.yml /home/ansible/site.yml --connection=local --become --extra-vars '{"users": [{"username": "testuser1"}, {"username": "testuser2"}]}' --skip-tags "common"
```
or simply use the test scripts
```bash
sh test/test.sh 43 all
```
__Note__: We skip everything related to systemd, since systemd is not monitoring our services in the container.
After the test has finished you can stop the container and remove it:
```bash
docker rm test-fedora
```
## Note
I created this project for the purpose of educating myself and personal use. If you are interested in the outcome, feel free to contribute; this work is published under the MIT license.