az2aws 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.release-please-manifest.json +1 -1
- package/CHANGELOG.md +7 -0
- package/CONTRIBUTING.md +92 -1
- package/README.md +30 -20
- package/package.json +2 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [1.1.1](https://github.com/kuma0128/az2aws/compare/v1.1.0...v1.1.1) (2026-01-19)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Bug Fixes
|
|
7
|
+
|
|
8
|
+
* update Snapcraft config to use npm plugin ([#59](https://github.com/kuma0128/az2aws/issues/59)) ([e574441](https://github.com/kuma0128/az2aws/commit/e57444187fc37460c3838d973c28563fe9e13913))
|
|
9
|
+
|
|
3
10
|
## [1.1.0](https://github.com/kuma0128/az2aws/compare/v1.0.2...v1.1.0) (2026-01-09)
|
|
4
11
|
|
|
5
12
|
|
package/CONTRIBUTING.md
CHANGED
|
@@ -10,6 +10,7 @@ Thank you for your interest in contributing to az2aws! This document provides gu
|
|
|
10
10
|
- [Pull Request Process](#pull-request-process)
|
|
11
11
|
- [Coding Standards](#coding-standards)
|
|
12
12
|
- [Commit Message Guidelines](#commit-message-guidelines)
|
|
13
|
+
- [Release Process](#release-process)
|
|
13
14
|
- [Reporting Issues](#reporting-issues)
|
|
14
15
|
|
|
15
16
|
## Code of Conduct
|
|
@@ -193,7 +194,97 @@ src/
|
|
|
193
194
|
|
|
194
195
|
## Commit Message Guidelines
|
|
195
196
|
|
|
196
|
-
|
|
197
|
+
This project uses [Conventional Commits](https://www.conventionalcommits.org/) for commit messages. The commit message format is used by [release-please](https://github.com/googleapis/release-please) to automatically generate changelogs and determine version bumps.
|
|
198
|
+
|
|
199
|
+
### Commit Message Format
|
|
200
|
+
|
|
201
|
+
```
|
|
202
|
+
<type>(<scope>): <description>
|
|
203
|
+
|
|
204
|
+
[optional body]
|
|
205
|
+
|
|
206
|
+
[optional footer(s)]
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
### Commit Types and Their Effects
|
|
210
|
+
|
|
211
|
+
| Type | CHANGELOG Section | Release Trigger | Version Bump |
|
|
212
|
+
|------|-------------------|-----------------|--------------|
|
|
213
|
+
| `feat` | Features | Yes | MINOR (1.x.0) |
|
|
214
|
+
| `fix` | Bug Fixes | Yes | PATCH (1.0.x) |
|
|
215
|
+
| `docs` | Not included | No | - |
|
|
216
|
+
| `chore` | Not included | No | - |
|
|
217
|
+
| `refactor` | Not included | No | - |
|
|
218
|
+
| `test` | Not included | No | - |
|
|
219
|
+
| `style` | Not included | No | - |
|
|
220
|
+
| `perf` | Performance Improvements | Yes | PATCH (1.0.x) |
|
|
221
|
+
|
|
222
|
+
### Breaking Changes
|
|
223
|
+
|
|
224
|
+
For breaking changes, add `!` after the type or include `BREAKING CHANGE:` in the footer:
|
|
225
|
+
|
|
226
|
+
```
|
|
227
|
+
feat!: remove deprecated --legacy flag
|
|
228
|
+
|
|
229
|
+
BREAKING CHANGE: The --legacy flag has been removed. Use --mode instead.
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
Breaking changes trigger a MAJOR version bump (x.0.0).
|
|
233
|
+
|
|
234
|
+
### Examples
|
|
235
|
+
|
|
236
|
+
```sh
|
|
237
|
+
# New feature (triggers MINOR release, appears in CHANGELOG)
|
|
238
|
+
feat: add support for credential_process
|
|
239
|
+
|
|
240
|
+
# Bug fix (triggers PATCH release, appears in CHANGELOG)
|
|
241
|
+
fix: resolve proxy configuration conflict
|
|
242
|
+
|
|
243
|
+
# Documentation only (no release, not in CHANGELOG)
|
|
244
|
+
docs: update installation instructions
|
|
245
|
+
|
|
246
|
+
# If you want documentation changes to appear in CHANGELOG, use feat:
|
|
247
|
+
feat(docs): add mise installation guide
|
|
248
|
+
|
|
249
|
+
# Maintenance (no release, not in CHANGELOG)
|
|
250
|
+
chore: update dependencies
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
### Important Notes
|
|
254
|
+
|
|
255
|
+
- **PR titles matter**: When a PR is squash-merged, the PR title becomes the commit message. Ensure your PR title follows this format.
|
|
256
|
+
- **Use `feat(docs):`** if you want documentation changes to appear in the changelog and trigger a release.
|
|
257
|
+
- Commit messages can be generated using an LLM model, but ensure they follow the Conventional Commits format.
|
|
258
|
+
|
|
259
|
+
## Release Process
|
|
260
|
+
|
|
261
|
+
This project uses [release-please](https://github.com/googleapis/release-please) for automated releases.
|
|
262
|
+
|
|
263
|
+
### How It Works
|
|
264
|
+
|
|
265
|
+
1. When PRs are merged to `main`, release-please analyzes commit messages
|
|
266
|
+
2. If releasable commits exist (`feat`, `fix`, `perf`, or breaking changes), release-please creates/updates a Release PR
|
|
267
|
+
3. The Release PR contains:
|
|
268
|
+
- Version bump in `package.json`
|
|
269
|
+
- Updated `CHANGELOG.md` with all changes since the last release
|
|
270
|
+
4. When the Release PR is merged, a new GitHub release is created with the appropriate tag
|
|
271
|
+
|
|
272
|
+
### What Triggers a Release
|
|
273
|
+
|
|
274
|
+
| Commit Type | Triggers Release? | Example |
|
|
275
|
+
|-------------|-------------------|---------|
|
|
276
|
+
| `feat:` | Yes (MINOR) | `feat: add SSO support` |
|
|
277
|
+
| `fix:` | Yes (PATCH) | `fix: handle timeout error` |
|
|
278
|
+
| `perf:` | Yes (PATCH) | `perf: optimize credential caching` |
|
|
279
|
+
| `feat!:` / `BREAKING CHANGE` | Yes (MAJOR) | `feat!: change config format` |
|
|
280
|
+
| `docs:` | No | `docs: update README` |
|
|
281
|
+
| `chore:` | No | `chore: update deps` |
|
|
282
|
+
|
|
283
|
+
### Tips for Contributors
|
|
284
|
+
|
|
285
|
+
- If your change should appear in the release notes, use `feat:` or `fix:`
|
|
286
|
+
- For documentation improvements that benefit users, consider using `feat(docs):` to include them in the release
|
|
287
|
+
- Multiple commits of the same type are grouped together in the CHANGELOG
|
|
197
288
|
|
|
198
289
|
## Reporting Issues
|
|
199
290
|
|
package/README.md
CHANGED
|
@@ -9,50 +9,60 @@ If your organization uses [Azure Active Directory](https://azure.microsoft.com)
|
|
|
9
9
|
|
|
10
10
|
## Installation
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
### mise (Recommended)
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
[mise](https://mise.jdx.dev/) is a polyglot version manager that can install az2aws directly.
|
|
15
15
|
|
|
16
|
-
Install
|
|
16
|
+
Install mise:
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
curl https://mise.run | sh
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
Activate mise in your shell:
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
# For zsh (macOS default)
|
|
23
|
+
echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc
|
|
24
|
+
source ~/.zshrc
|
|
23
25
|
|
|
24
|
-
|
|
26
|
+
# For bash (Linux default)
|
|
27
|
+
echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
|
|
28
|
+
source ~/.bashrc
|
|
25
29
|
|
|
26
|
-
|
|
30
|
+
Install az2aws:
|
|
27
31
|
|
|
28
|
-
|
|
32
|
+
mise use -g npm:az2aws
|
|
29
33
|
|
|
30
|
-
|
|
34
|
+
### npm
|
|
31
35
|
|
|
32
|
-
|
|
36
|
+
Install [Node.js](https://nodejs.org/) v24 or higher, then install az2aws:
|
|
33
37
|
|
|
34
|
-
|
|
38
|
+
npm install -g az2aws
|
|
35
39
|
|
|
36
|
-
|
|
40
|
+
#### Linux Notes
|
|
41
|
+
|
|
42
|
+
You must install [puppeteer dependencies](https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md#chrome-headless-doesnt-launch) first.
|
|
43
|
+
|
|
44
|
+
**Install for all users:**
|
|
37
45
|
|
|
38
|
-
|
|
46
|
+
sudo npm install -g az2aws --unsafe-perm
|
|
47
|
+
sudo chmod -R go+rx $(npm root -g)
|
|
39
48
|
|
|
40
|
-
|
|
49
|
+
**Install for current user only:**
|
|
41
50
|
|
|
42
51
|
mkdir ~/.npm-global
|
|
43
52
|
npm config set prefix '~/.npm-global'
|
|
44
|
-
export PATH=~/.npm-global/bin:$PATH
|
|
45
|
-
source ~/.profile
|
|
46
53
|
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
|
|
47
54
|
source ~/.profile
|
|
55
|
+
npm install -g az2aws
|
|
48
56
|
|
|
49
|
-
|
|
57
|
+
#### Windows Notes
|
|
50
58
|
|
|
51
|
-
|
|
59
|
+
If you get a missing Chrome/Chromium error, install the puppeteer dependency manually:
|
|
60
|
+
|
|
61
|
+
node <node_modules_dir>/az2aws/node_modules/puppeteer/install.js
|
|
52
62
|
|
|
53
63
|
### Docker
|
|
54
64
|
|
|
55
|
-
|
|
65
|
+
Run az2aws with a volume mounted to your AWS configuration directory:
|
|
56
66
|
|
|
57
67
|
docker run --rm -it -v ~/.aws:/root/.aws az2aws/az2aws
|
|
58
68
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "az2aws",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.1",
|
|
4
4
|
"description": "Use Azure AD SSO to log into the AWS CLI. A modern, actively maintained alternative to aws-azure-login.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"author": {
|
|
@@ -55,6 +55,7 @@
|
|
|
55
55
|
"dependencies": {
|
|
56
56
|
"@aws-sdk/client-sts": "^3.723.0",
|
|
57
57
|
"@smithy/node-http-handler": "^2.5.0",
|
|
58
|
+
"az2aws": "^1.1.0",
|
|
58
59
|
"bluebird": "^3.7.2",
|
|
59
60
|
"cheerio": "^1.0.0-rc.10",
|
|
60
61
|
"commander": "^9.5.0",
|