Skip to content

Commit 1721880

Browse files
committed
lint
1 parent 892eaca commit 1721880

1 file changed

Lines changed: 28 additions & 20 deletions

File tree

README.md

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,65 @@
11
# Jit Customer Scripts README
22

33
The README provided is an extensive guide on how to use the `jit-customer-scripts` project. \
4-
The Makefile described is composed of commands that ease the installation, configuration, and running of the scripts within the project. \
4+
The Makefile described is composed of commands that ease the installation, configuration, and running of the scripts
5+
within the project. \
56
Here's a breakdown of the provided README and Makefile:
67

78
## README Overview
89

9-
- **Introduction**: The README begins with a brief description of the project and its purpose, which is to aid customers in creating teams and updating assets based on a given JSON file.
10+
- **Introduction**: The README begins with a brief description of the project and its purpose, which is to aid customers
11+
in creating teams and updating assets based on a given JSON file.
1012
- **Project Structure**: An organized visual representation of the project's file structure is provided.
11-
- **Prerequisites**: Lists necessary software that should be installed before starting, along with instructions for CentOS and Ubuntu to prepare the environment.
13+
- **Prerequisites**: Lists necessary software that should be installed before starting, along with instructions for
14+
CentOS and Ubuntu to prepare the environment.
1215
- **Generating API Keys**: Guidance on how to generate the necessary Github Personal Access Token and Jit API Key.
1316
- **Installation**: Steps on cloning the repository and setting up the project.
1417
- **Configuration**: Instructions on how to configure the necessary environment variables for the script.
1518
- **Usage**:
16-
- **Creating Teams from Github Topics**: Details on how to use the script to create teams and update assets from GitHub topics.
17-
- **Using External JSON File**: Allows users to directly provide a JSON file containing team details.
18-
- **Excluding Topics**: Instructions on excluding specific topics when creating teams.
19-
- **Setting Up Self-Hosted Runners**: Guidance on setting up GitHub self-hosted runners on both CentOS and Ubuntu.
20-
- **Help**: Instruction on getting help with the Makefile commands.
21-
- **Development**: A small note about overriding the Jit API endpoint.
19+
- **Creating Teams from Github Topics**: Details on how to use the script to create teams and update assets from
20+
GitHub topics.
21+
- **Using External JSON File**: Allows users to directly provide a JSON file containing team details.
22+
- **Excluding Topics**: Instructions on excluding specific topics when creating teams.
23+
- **Setting Up Self-Hosted Runners**: Guidance on setting up GitHub self-hosted runners on both CentOS and Ubuntu.
24+
- **Help**: Instruction on getting help with the Makefile commands.
25+
- **Development**: A small note about overriding the Jit API endpoint.
2226

2327
## Makefile Overview
2428

25-
The Makefile consists of several targets to facilitate the installation, configuration, and running of scripts. Here's a breakdown:
29+
The Makefile consists of several targets to facilitate the installation, configuration, and running of scripts. Here's a
30+
breakdown:
2631

2732
### sync-teams
33+
2834
This target has three sub-targets:
35+
2936
- `install`: Ensures Python 3 is installed, sets up a virtual environment, and installs the required dependencies.
30-
- `configure`: Prompts the user to input configuration details like GitHub organization name, API client ID, client secret, and GitHub token. The responses are written to a `.env` file.
37+
- `configure`: Prompts the user to input configuration details like GitHub organization name, API client ID, client
38+
secret, and GitHub token. The responses are written to a `.env` file.
3139
- `run`: Activates the virtual environment and runs two Python scripts in succession to generate teams.
3240

3341
### self-hosted-runner
42+
3443
This target and its sub-targets facilitate setting up a GitHub self-hosted runner:
44+
3545
- `check-root`: Ensures the script isn't run as root.
3646
- `setup-runner`: Checks the platform (CentOS or Ubuntu) and runs the appropriate setup script.
3747
- `install-agent`: Installs the GitHub runner agent.
3848

3949
### Help
50+
4051
- `help`: Displays available targets and their brief descriptions.
4152

4253
## Hierarchical Structure of the Commands:
4354

4455
1. **sync-teams**
45-
- install
46-
- configure
47-
- run
56+
- install
57+
- configure
58+
- run
4859

4960
2. **self-hosted-runner**
50-
- centos
51-
- ubuntu
61+
- centos
62+
- ubuntu
5263

5364
## Project Structure
5465

@@ -79,14 +90,12 @@ jit-customer-scripts/
7990
- `Makefile`: Provides commands to help with project setup and execution.
8091
- `README.md`: This file.
8192

82-
8393
## Prerequisites
8494

8595
- Python 3.x
8696
- Git
8797
- make
8898

89-
9099
To make sure you have all you can run this command:
91100

92101
#### Centos
@@ -215,7 +224,6 @@ This will exclude topics with names like "test", "test123", and "abc-testing".
215224
To override Jit's API endpoint, you can set the `JIT_API_ENDPOINT` environment variable. If the variable is not set, the
216225
default value will be used.
217226

218-
219227
## Settings Up Self-Hosted Runners
220228

221229
To setup self-hosted runners, use the following command:
@@ -253,4 +261,4 @@ To see the available commands and their descriptions, use the following command:
253261

254262
```shell
255263
make help
256-
```
264+
```

0 commit comments

Comments
 (0)