mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-08-29 23:08:06 +02:00
Refactored pc roles and added README.md's with help of ChatGPT. See https://chat.openai.com/share/df22ba6a-76d0-47c2-a8c7-daec3f42b4e5
This commit is contained in:
38
roles/pc-developer-tools-arduino/README.md
Normal file
38
roles/pc-developer-tools-arduino/README.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# PC-Developer-Tools-Arduino Role
|
||||
|
||||
## Overview
|
||||
This README file is for the `pc-developer-tools-arduino` role, a specialized component of the `computer-playbook` repository. This role is specifically crafted for setting up Arduino development tools on personal computers.
|
||||
|
||||
## Role Details
|
||||
The `main.yml` file in the `pc-developer-tools-arduino` role encompasses tasks crucial for Arduino developers:
|
||||
|
||||
1. **Install Arduino Developer Tools**:
|
||||
- This task employs the `community.general.pacman` module to install:
|
||||
- `arduino`: The Arduino IDE, which is an open-source electronics platform based on easy-to-use hardware and software.
|
||||
- `arduino-docs`: Documentation for Arduino, providing essential information for development.
|
||||
|
||||
2. **Adding User to Relevant Arduino Usergroups**:
|
||||
- This task modifies the user (specified by `{{client_username}}`) to be added to the `uucp` and `lock` groups, which is necessary for accessing serial ports on Linux systems.
|
||||
|
||||
## Dependencies
|
||||
The role depends on:
|
||||
- **pc-developer-tools**: Ensures that base developer tools, including code editors and related software, are installed and configured.
|
||||
|
||||
## Purpose and Usage
|
||||
The `pc-developer-tools-arduino` role is tailored for developers and hobbyists who work with Arduino boards and need a reliable and efficient setup for their development environment. This role simplifies the process of installing and configuring the Arduino IDE and associated documentation, along with setting up necessary user permissions.
|
||||
|
||||
## Prerequisites
|
||||
- **Ansible**: Required for executing this role.
|
||||
- **Arch Linux-based System**: The role uses `pacman`, indicating it is designed for Arch Linux-based distributions.
|
||||
|
||||
## Running the Role
|
||||
To utilize this role:
|
||||
1. Clone the `computer-playbook` repository.
|
||||
2. Navigate to the `roles/pc-developer-tools-arduino` directory.
|
||||
3. Execute the role using Ansible, ensuring you replace `{{client_username}}` with the actual username and have the necessary system permissions.
|
||||
|
||||
## Customization
|
||||
This role can be customized to include additional Arduino-related packages or tools, depending on the user's requirements.
|
||||
|
||||
## Support and Contributions
|
||||
For support, suggestions, or contributions (like adding more Arduino-related tools or improving the setup), please raise an issue or submit a pull request in the `computer-playbook` repository. Contributions that enhance the Arduino development environment setup are highly encouraged.
|
2
roles/pc-developer-tools-arduino/meta/main.yml
Normal file
2
roles/pc-developer-tools-arduino/meta/main.yml
Normal file
@@ -0,0 +1,2 @@
|
||||
dependencies:
|
||||
- pc-developer-tools
|
11
roles/pc-developer-tools-arduino/tasks/main.yml
Normal file
11
roles/pc-developer-tools-arduino/tasks/main.yml
Normal file
@@ -0,0 +1,11 @@
|
||||
- name: install arduino developer tools
|
||||
community.general.pacman:
|
||||
name:
|
||||
- arduino
|
||||
- arduino-docs
|
||||
state: present
|
||||
|
||||
- name: Adding user {{client_username}} to relevant arduino usergroups
|
||||
user: name={{client_username}}
|
||||
groups=uucp lock
|
||||
append=yes
|
Reference in New Issue
Block a user