You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTION.md
+25-9Lines changed: 25 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,47 +1,57 @@
1
1
Thank you for considering contributing to the Cloudsmith CLI Install Action! Here are the steps to create a Pull Request (PR) and the necessary variables and secrets for GitHub Actions.
2
+
2
3
## How to Create PRs (Fork)
4
+
3
5
### Fork the Repository:
6
+
4
7
- Navigate to the Cloudsmith CLI Install Action repository.
5
8
- Click the "Fork" button at the top right of the page.
6
9
7
10
### Clone Your Fork:
11
+
8
12
- Open your terminal and clone your forked repository:
9
13
10
14
```
11
15
git clone <your-forked-repo-url>
12
16
```
13
17
14
18
### Create a New Branch:
19
+
15
20
- Create a new branch for your feature or bug fix:
16
21
17
22
```
18
23
git checkout -b <branch-name>
19
24
```
20
25
21
26
### Make Your Changes:
27
+
22
28
- Make the necessary changes in your local repository.
23
29
24
30
### Commit Your Changes:
31
+
25
32
- Commit your changes with a descriptive message:
26
33
27
34
```
28
35
git commit -m "Your commit message"
29
36
```
30
37
31
38
### Push Your Changes:
39
+
32
40
- Push your changes to your forked repository:
33
41
34
42
```
35
43
git push origin <branch-name>
36
44
```
37
45
38
46
### Create a Pull Request:
47
+
39
48
- Navigate to your forked repository on GitHub.
40
49
- Click the "Compare & pull request" button.
41
50
- Provide a descriptive title and detailed description of your changes.
42
51
- Click "Create pull request".
43
52
44
53
## Running Locally
54
+
45
55
To run this project locally, you need to have Node.js and npm installed. Follow these steps:
46
56
47
57
- Install the dependencies:
@@ -60,39 +70,45 @@ npm run build
60
70
- Configure the variables below and trigger the test action.
61
71
62
72
## Variables and Secrets for GitHub Actions
73
+
63
74
To run the GitHub Actions workflows, you need to set up the following variables and secrets in your repository:
64
75
65
76
### Variables:
77
+
66
78
- NAMESPACE: Your Cloudsmith OIDC namespace.
67
79
- SERVICE_ACCOUNT: Your Cloudsmith OIDC service account slug.
68
80
69
81
### Secrets:
82
+
70
83
- CLOUDSMITH_API_KEY: Your Cloudsmith API key.
71
84
72
85
To add these variables and secrets:
73
86
74
87
1. Navigate to Your Repository Settings:
75
-
- Go to your repository on GitHub.
76
-
- Click on "Settings".
88
+
89
+
- Go to your repository on GitHub.
90
+
- Click on "Settings".
77
91
78
92
2. Add Variables:
79
-
- Go to "Secrets and variables" > "Actions" > "Variables".
80
-
- Click "New repository variable" and add NAMESPACE and SERVICE_ACCOUNT.
93
+
94
+
- Go to "Secrets and variables" > "Actions" > "Variables".
95
+
- Click "New repository variable" and add NAMESPACE and SERVICE_ACCOUNT.
81
96
82
97
3. Add Secrets:
83
-
- Go to "Secrets and variables" > "Actions" > "Secrets".
84
-
- Click "New repository secret" and add CLOUDSMITH_API_KEY.
98
+
- Go to "Secrets and variables" > "Actions" > "Secrets".
99
+
- Click "New repository secret" and add CLOUDSMITH_API_KEY.
85
100
86
101
## Example Commands/Code to Change
102
+
87
103
Here is an example of how you might modify the [`test_install.yml`](".github/workflows/test_install.yml") workflow to use a different CLI version and authentication method:
88
104
89
105
```yaml
90
106
- name: Install Cloudsmith CLI
91
107
uses: cloudsmith-io/cloudsmith-cli-action@v1
92
108
with:
93
-
cli-version: 1.3.0
94
-
auth-method: token
95
-
token: ${{ secrets.CLOUDSMITH_API_KEY }}
109
+
cli-version: 1.3.0
110
+
auth-method: token
111
+
token: ${{ secrets.CLOUDSMITH_API_KEY }}
96
112
```
97
113
98
114
You can modify other inputs similarly based on your requirements.
Please check our [CONTRIBUTION](CONTRIBUTION.md) doc for more information. 🤝
@@ -108,4 +109,3 @@ This project is licensed under the MIT License - see the LICENSE file for detail
108
109
## Support
109
110
110
111
If you have any questions or need further assistance, please open an issue on GitHub. We're here to help! 💬 Alternatively, you can contact us at [support.cloudsmith.com](https://support.cloudsmith.com/).
0 commit comments