balena-cli 23.2.1 → 23.2.2-build-renovate-major-6-github-artifact-actions-92eee38f4ad591499bc5543395d9fbc862ab0907-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/CHANGELOG.md CHANGED
@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file
4
4
  automatically by Versionist. DO NOT EDIT THIS FILE MANUALLY!
5
5
  This project adheres to [Semantic Versioning](http://semver.org/).
6
6
 
7
+ ## 23.2.2 - 2025-12-02
8
+
9
+ * Update actions/download-artifact action to v6 [balena-renovate[bot]]
10
+
7
11
  ## 23.2.1 - 2025-12-02
8
12
 
9
13
  * tests/os/configure.spec: Abstract the temp image creation and cleanup [Thodoris Greasidis]
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "balena-cli",
3
- "version": "23.2.1",
3
+ "version": "23.2.2-build-renovate-major-6-github-artifact-actions-92eee38f4ad591499bc5543395d9fbc862ab0907-1",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "balena-cli",
9
- "version": "23.2.1",
9
+ "version": "23.2.2-build-renovate-major-6-github-artifact-actions-92eee38f4ad591499bc5543395d9fbc862ab0907-1",
10
10
  "hasInstallScript": true,
11
11
  "license": "Apache-2.0",
12
12
  "dependencies": {
@@ -160,6 +160,56 @@
160
160
  "create.js"
161
161
  ]
162
162
  },
163
+ "block:create": {
164
+ "aliases": [],
165
+ "args": {
166
+ "name": {
167
+ "description": "block name",
168
+ "name": "name",
169
+ "required": true
170
+ }
171
+ },
172
+ "description": "Create an block.\n\nCreate a new balena block.\n\nYou can specify the organization the block should belong to using\nthe `--organization` option. The organization's handle, not its name,\nshould be provided. Organization handles can be listed with the\n`balena organization list` command.\n\nThe block's default device type is specified with the `--type` option.\nThe `balena device-type list` command can be used to list the available\ndevice types.\n\nInteractive dropdowns will be shown for selection if no device type or\norganization is specified and there are multiple options to choose from.\nIf there is a single option to choose from, it will be chosen automatically.\nThis interactive behavior can be disabled by explicitly specifying a device\ntype and organization.",
173
+ "examples": [
174
+ "$ balena block create MyBlock",
175
+ "$ balena block create MyBlock --organization mmyorg",
176
+ "$ balena block create MyBlock -o myorg --type raspberry-pi"
177
+ ],
178
+ "flags": {
179
+ "organization": {
180
+ "char": "o",
181
+ "description": "handle of the organization the block should belong to",
182
+ "name": "organization",
183
+ "hasDynamicHelp": false,
184
+ "multiple": false,
185
+ "type": "option"
186
+ },
187
+ "type": {
188
+ "char": "t",
189
+ "description": "block device type (Check available types with `balena device-type list`)",
190
+ "name": "type",
191
+ "hasDynamicHelp": false,
192
+ "multiple": false,
193
+ "type": "option"
194
+ }
195
+ },
196
+ "hasDynamicHelp": false,
197
+ "hiddenAliases": [],
198
+ "id": "block:create",
199
+ "pluginAlias": "balena-cli",
200
+ "pluginName": "balena-cli",
201
+ "pluginType": "core",
202
+ "strict": true,
203
+ "enableJsonFlag": false,
204
+ "authenticated": true,
205
+ "isESM": false,
206
+ "relativePath": [
207
+ "build",
208
+ "commands",
209
+ "block",
210
+ "create.js"
211
+ ]
212
+ },
163
213
  "build": {
164
214
  "aliases": [],
165
215
  "args": {
@@ -362,56 +412,6 @@
362
412
  "index.js"
363
413
  ]
364
414
  },
365
- "block:create": {
366
- "aliases": [],
367
- "args": {
368
- "name": {
369
- "description": "block name",
370
- "name": "name",
371
- "required": true
372
- }
373
- },
374
- "description": "Create an block.\n\nCreate a new balena block.\n\nYou can specify the organization the block should belong to using\nthe `--organization` option. The organization's handle, not its name,\nshould be provided. Organization handles can be listed with the\n`balena organization list` command.\n\nThe block's default device type is specified with the `--type` option.\nThe `balena device-type list` command can be used to list the available\ndevice types.\n\nInteractive dropdowns will be shown for selection if no device type or\norganization is specified and there are multiple options to choose from.\nIf there is a single option to choose from, it will be chosen automatically.\nThis interactive behavior can be disabled by explicitly specifying a device\ntype and organization.",
375
- "examples": [
376
- "$ balena block create MyBlock",
377
- "$ balena block create MyBlock --organization mmyorg",
378
- "$ balena block create MyBlock -o myorg --type raspberry-pi"
379
- ],
380
- "flags": {
381
- "organization": {
382
- "char": "o",
383
- "description": "handle of the organization the block should belong to",
384
- "name": "organization",
385
- "hasDynamicHelp": false,
386
- "multiple": false,
387
- "type": "option"
388
- },
389
- "type": {
390
- "char": "t",
391
- "description": "block device type (Check available types with `balena device-type list`)",
392
- "name": "type",
393
- "hasDynamicHelp": false,
394
- "multiple": false,
395
- "type": "option"
396
- }
397
- },
398
- "hasDynamicHelp": false,
399
- "hiddenAliases": [],
400
- "id": "block:create",
401
- "pluginAlias": "balena-cli",
402
- "pluginName": "balena-cli",
403
- "pluginType": "core",
404
- "strict": true,
405
- "enableJsonFlag": false,
406
- "authenticated": true,
407
- "isESM": false,
408
- "relativePath": [
409
- "build",
410
- "commands",
411
- "block",
412
- "create.js"
413
- ]
414
- },
415
415
  "config:generate": {
416
416
  "aliases": [],
417
417
  "args": {},
@@ -3209,53 +3209,159 @@
3209
3209
  "index.js"
3210
3210
  ]
3211
3211
  },
3212
- "logout": {
3212
+ "organization:list": {
3213
3213
  "aliases": [],
3214
3214
  "args": {},
3215
- "description": "Logout from balena.\n\nLogout from your balena account.",
3215
+ "description": "List all organizations.\n\nlist all the organizations that you are a member of.",
3216
3216
  "examples": [
3217
- "$ balena logout"
3217
+ "$ balena organization list"
3218
3218
  ],
3219
3219
  "flags": {},
3220
3220
  "hasDynamicHelp": false,
3221
3221
  "hiddenAliases": [],
3222
- "id": "logout",
3222
+ "id": "organization:list",
3223
3223
  "pluginAlias": "balena-cli",
3224
3224
  "pluginName": "balena-cli",
3225
3225
  "pluginType": "core",
3226
3226
  "strict": true,
3227
3227
  "enableJsonFlag": false,
3228
+ "authenticated": true,
3228
3229
  "isESM": false,
3229
3230
  "relativePath": [
3230
3231
  "build",
3231
3232
  "commands",
3232
- "logout",
3233
- "index.js"
3233
+ "organization",
3234
+ "list.js"
3234
3235
  ]
3235
3236
  },
3236
- "organization:list": {
3237
+ "preload": {
3237
3238
  "aliases": [],
3238
- "args": {},
3239
- "description": "List all organizations.\n\nlist all the organizations that you are a member of.",
3239
+ "args": {
3240
+ "image": {
3241
+ "description": "the image file path",
3242
+ "name": "image",
3243
+ "required": true
3244
+ }
3245
+ },
3246
+ "description": "Preload a release on a disk image (or Edison zip archive).\n\nPreload a release (service images/containers) from a balena fleet, and optionally\na balenaOS splash screen, in a previously downloaded '.img' balenaOS image file\nin the local disk (a zip file is only accepted for the Intel Edison device type).\nAfter preloading, the balenaOS image file can be flashed to a device's SD card.\nWhen the device boots, it will not need to download the release, as it was\npreloaded. This is usually combined with release pinning\n(https://www.balena.io/docs/learn/deploy/release-strategy/release-policy/)\nto avoid the device downloading a newer release straight away, if available.\nCheck also the Preloading and Preregistering section of the balena CLI's advanced\nmasterclass document:\nhttps://www.balena.io/docs/learn/more/masterclasses/advanced-cli/#5-preloading-and-preregistering\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).\n\nNote that the this command requires Docker to be installed, as further detailed\nin the balena CLI's installation instructions:\nhttps://github.com/balena-io/balena-cli/blob/master/INSTALL.md\nThe `--dockerHost` and `--dockerPort` flags allow a remote Docker engine to\nbe used, however the image file must be accessible to the remote Docker engine\non the same path given on the command line. This is because Docker's bind mount\nfeature is used to \"share\" the image with a container that performs the preload.",
3240
3247
  "examples": [
3241
- "$ balena organization list"
3248
+ "$ balena preload balena.img --fleet MyFleet --commit e1f2592fc6ee949e68756d4f4a48e49bff8d72a0",
3249
+ "$ balena preload balena.img --fleet myorg/myfleet --splash-image image.png",
3250
+ "$ balena preload balena.img"
3242
3251
  ],
3243
- "flags": {},
3252
+ "flags": {
3253
+ "fleet": {
3254
+ "char": "f",
3255
+ "description": "fleet name or slug (preferred)",
3256
+ "name": "fleet",
3257
+ "hasDynamicHelp": false,
3258
+ "multiple": false,
3259
+ "type": "option"
3260
+ },
3261
+ "commit": {
3262
+ "char": "c",
3263
+ "description": "The commit hash of the release to preload. Use \"current\" to specify the current\nrelease (ignored if no appId is given). The current release is usually also the\nlatest, but can be pinned to a specific release. See:\nhttps://www.balena.io/docs/learn/deploy/release-strategy/release-policy/\nhttps://www.balena.io/docs/learn/more/masterclasses/fleet-management/#63-pin-using-the-api\nhttps://github.com/balena-io-examples/staged-releases",
3264
+ "name": "commit",
3265
+ "hasDynamicHelp": false,
3266
+ "multiple": false,
3267
+ "type": "option"
3268
+ },
3269
+ "splash-image": {
3270
+ "char": "s",
3271
+ "description": "path to a png image to replace the splash screen",
3272
+ "name": "splash-image",
3273
+ "hasDynamicHelp": false,
3274
+ "multiple": false,
3275
+ "type": "option"
3276
+ },
3277
+ "dont-check-arch": {
3278
+ "description": "disable architecture compatibility check between image and fleet",
3279
+ "name": "dont-check-arch",
3280
+ "allowNo": false,
3281
+ "type": "boolean"
3282
+ },
3283
+ "pin-device-to-release": {
3284
+ "char": "p",
3285
+ "description": "pin the preloaded device to the preloaded release on provision",
3286
+ "name": "pin-device-to-release",
3287
+ "allowNo": true,
3288
+ "type": "boolean"
3289
+ },
3290
+ "additional-space": {
3291
+ "description": "expand the image by this amount of bytes instead of automatically estimating the required amount",
3292
+ "name": "additional-space",
3293
+ "hasDynamicHelp": false,
3294
+ "multiple": false,
3295
+ "type": "option"
3296
+ },
3297
+ "add-certificate": {
3298
+ "description": "Add the given certificate (in PEM format) to /etc/ssl/certs in the preloading container.\nThe file name must end with '.crt' and must not be already contained in the preloader's\n/etc/ssl/certs folder.\nCan be repeated to add multiple certificates.",
3299
+ "name": "add-certificate",
3300
+ "hasDynamicHelp": false,
3301
+ "multiple": true,
3302
+ "type": "option"
3303
+ },
3304
+ "docker": {
3305
+ "char": "P",
3306
+ "description": "Path to a local docker socket (e.g. /var/run/docker.sock)",
3307
+ "name": "docker",
3308
+ "hasDynamicHelp": false,
3309
+ "multiple": false,
3310
+ "type": "option"
3311
+ },
3312
+ "dockerHost": {
3313
+ "char": "h",
3314
+ "description": "Docker daemon hostname or IP address (dev machine or balena device) ",
3315
+ "name": "dockerHost",
3316
+ "hasDynamicHelp": false,
3317
+ "multiple": false,
3318
+ "type": "option"
3319
+ },
3320
+ "dockerPort": {
3321
+ "description": "Docker daemon TCP port number (hint: 2375 for balena devices)",
3322
+ "name": "dockerPort",
3323
+ "hasDynamicHelp": false,
3324
+ "multiple": false,
3325
+ "type": "option"
3326
+ },
3327
+ "ca": {
3328
+ "description": "Docker host TLS certificate authority file",
3329
+ "name": "ca",
3330
+ "hasDynamicHelp": false,
3331
+ "multiple": false,
3332
+ "type": "option"
3333
+ },
3334
+ "cert": {
3335
+ "description": "Docker host TLS certificate file",
3336
+ "name": "cert",
3337
+ "hasDynamicHelp": false,
3338
+ "multiple": false,
3339
+ "type": "option"
3340
+ },
3341
+ "key": {
3342
+ "description": "Docker host TLS key file",
3343
+ "name": "key",
3344
+ "hasDynamicHelp": false,
3345
+ "multiple": false,
3346
+ "type": "option"
3347
+ }
3348
+ },
3244
3349
  "hasDynamicHelp": false,
3245
3350
  "hiddenAliases": [],
3246
- "id": "organization:list",
3351
+ "id": "preload",
3247
3352
  "pluginAlias": "balena-cli",
3248
3353
  "pluginName": "balena-cli",
3249
3354
  "pluginType": "core",
3250
3355
  "strict": true,
3251
3356
  "enableJsonFlag": false,
3252
3357
  "authenticated": true,
3358
+ "primary": true,
3253
3359
  "isESM": false,
3254
3360
  "relativePath": [
3255
3361
  "build",
3256
3362
  "commands",
3257
- "organization",
3258
- "list.js"
3363
+ "preload",
3364
+ "index.js"
3259
3365
  ]
3260
3366
  },
3261
3367
  "os:configure": {
@@ -3597,146 +3703,16 @@
3597
3703
  "versions.js"
3598
3704
  ]
3599
3705
  },
3600
- "preload": {
3706
+ "push": {
3601
3707
  "aliases": [],
3602
3708
  "args": {
3603
- "image": {
3604
- "description": "the image file path",
3605
- "name": "image",
3709
+ "fleetOrDevice": {
3710
+ "description": "fleet name or slug, or local device IP address or \".local\" hostname",
3711
+ "name": "fleetOrDevice",
3606
3712
  "required": true
3607
3713
  }
3608
3714
  },
3609
- "description": "Preload a release on a disk image (or Edison zip archive).\n\nPreload a release (service images/containers) from a balena fleet, and optionally\na balenaOS splash screen, in a previously downloaded '.img' balenaOS image file\nin the local disk (a zip file is only accepted for the Intel Edison device type).\nAfter preloading, the balenaOS image file can be flashed to a device's SD card.\nWhen the device boots, it will not need to download the release, as it was\npreloaded. This is usually combined with release pinning\n(https://www.balena.io/docs/learn/deploy/release-strategy/release-policy/)\nto avoid the device downloading a newer release straight away, if available.\nCheck also the Preloading and Preregistering section of the balena CLI's advanced\nmasterclass document:\nhttps://www.balena.io/docs/learn/more/masterclasses/advanced-cli/#5-preloading-and-preregistering\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).\n\nNote that the this command requires Docker to be installed, as further detailed\nin the balena CLI's installation instructions:\nhttps://github.com/balena-io/balena-cli/blob/master/INSTALL.md\nThe `--dockerHost` and `--dockerPort` flags allow a remote Docker engine to\nbe used, however the image file must be accessible to the remote Docker engine\non the same path given on the command line. This is because Docker's bind mount\nfeature is used to \"share\" the image with a container that performs the preload.",
3610
- "examples": [
3611
- "$ balena preload balena.img --fleet MyFleet --commit e1f2592fc6ee949e68756d4f4a48e49bff8d72a0",
3612
- "$ balena preload balena.img --fleet myorg/myfleet --splash-image image.png",
3613
- "$ balena preload balena.img"
3614
- ],
3615
- "flags": {
3616
- "fleet": {
3617
- "char": "f",
3618
- "description": "fleet name or slug (preferred)",
3619
- "name": "fleet",
3620
- "hasDynamicHelp": false,
3621
- "multiple": false,
3622
- "type": "option"
3623
- },
3624
- "commit": {
3625
- "char": "c",
3626
- "description": "The commit hash of the release to preload. Use \"current\" to specify the current\nrelease (ignored if no appId is given). The current release is usually also the\nlatest, but can be pinned to a specific release. See:\nhttps://www.balena.io/docs/learn/deploy/release-strategy/release-policy/\nhttps://www.balena.io/docs/learn/more/masterclasses/fleet-management/#63-pin-using-the-api\nhttps://github.com/balena-io-examples/staged-releases",
3627
- "name": "commit",
3628
- "hasDynamicHelp": false,
3629
- "multiple": false,
3630
- "type": "option"
3631
- },
3632
- "splash-image": {
3633
- "char": "s",
3634
- "description": "path to a png image to replace the splash screen",
3635
- "name": "splash-image",
3636
- "hasDynamicHelp": false,
3637
- "multiple": false,
3638
- "type": "option"
3639
- },
3640
- "dont-check-arch": {
3641
- "description": "disable architecture compatibility check between image and fleet",
3642
- "name": "dont-check-arch",
3643
- "allowNo": false,
3644
- "type": "boolean"
3645
- },
3646
- "pin-device-to-release": {
3647
- "char": "p",
3648
- "description": "pin the preloaded device to the preloaded release on provision",
3649
- "name": "pin-device-to-release",
3650
- "allowNo": true,
3651
- "type": "boolean"
3652
- },
3653
- "additional-space": {
3654
- "description": "expand the image by this amount of bytes instead of automatically estimating the required amount",
3655
- "name": "additional-space",
3656
- "hasDynamicHelp": false,
3657
- "multiple": false,
3658
- "type": "option"
3659
- },
3660
- "add-certificate": {
3661
- "description": "Add the given certificate (in PEM format) to /etc/ssl/certs in the preloading container.\nThe file name must end with '.crt' and must not be already contained in the preloader's\n/etc/ssl/certs folder.\nCan be repeated to add multiple certificates.",
3662
- "name": "add-certificate",
3663
- "hasDynamicHelp": false,
3664
- "multiple": true,
3665
- "type": "option"
3666
- },
3667
- "docker": {
3668
- "char": "P",
3669
- "description": "Path to a local docker socket (e.g. /var/run/docker.sock)",
3670
- "name": "docker",
3671
- "hasDynamicHelp": false,
3672
- "multiple": false,
3673
- "type": "option"
3674
- },
3675
- "dockerHost": {
3676
- "char": "h",
3677
- "description": "Docker daemon hostname or IP address (dev machine or balena device) ",
3678
- "name": "dockerHost",
3679
- "hasDynamicHelp": false,
3680
- "multiple": false,
3681
- "type": "option"
3682
- },
3683
- "dockerPort": {
3684
- "description": "Docker daemon TCP port number (hint: 2375 for balena devices)",
3685
- "name": "dockerPort",
3686
- "hasDynamicHelp": false,
3687
- "multiple": false,
3688
- "type": "option"
3689
- },
3690
- "ca": {
3691
- "description": "Docker host TLS certificate authority file",
3692
- "name": "ca",
3693
- "hasDynamicHelp": false,
3694
- "multiple": false,
3695
- "type": "option"
3696
- },
3697
- "cert": {
3698
- "description": "Docker host TLS certificate file",
3699
- "name": "cert",
3700
- "hasDynamicHelp": false,
3701
- "multiple": false,
3702
- "type": "option"
3703
- },
3704
- "key": {
3705
- "description": "Docker host TLS key file",
3706
- "name": "key",
3707
- "hasDynamicHelp": false,
3708
- "multiple": false,
3709
- "type": "option"
3710
- }
3711
- },
3712
- "hasDynamicHelp": false,
3713
- "hiddenAliases": [],
3714
- "id": "preload",
3715
- "pluginAlias": "balena-cli",
3716
- "pluginName": "balena-cli",
3717
- "pluginType": "core",
3718
- "strict": true,
3719
- "enableJsonFlag": false,
3720
- "authenticated": true,
3721
- "primary": true,
3722
- "isESM": false,
3723
- "relativePath": [
3724
- "build",
3725
- "commands",
3726
- "preload",
3727
- "index.js"
3728
- ]
3729
- },
3730
- "push": {
3731
- "aliases": [],
3732
- "args": {
3733
- "fleetOrDevice": {
3734
- "description": "fleet name or slug, or local device IP address or \".local\" hostname",
3735
- "name": "fleetOrDevice",
3736
- "required": true
3737
- }
3738
- },
3739
- "description": "Build release images on balenaCloud servers or on a local mode device.\n\nBuild release images on balenaCloud servers or on a local mode device.\n\nWhen building on the balenaCloud servers, the given source directory will be\nsent to the remote server. This can be used as a drop-in replacement for the\n\"git push\" deployment method.\n\nWhen building on a local mode device, the given source directory will be\nbuilt on the device, and the resulting containers will be run on the device.\nLogs will be streamed back from the device as part of the same invocation.\nThe web dashboard can be used to switch a device to local mode:\nhttps://www.balena.io/docs/learn/develop/local-mode/\nNote that local mode requires a supervisor version of at least v7.21.0.\nThe logs from only a single service can be shown with the --service flag, and\nshowing only the system logs can be achieved with --system. Note that these\nflags can be used together.\n\nWhen pushing to a local device a live session will be started.\nThe project source folder is watched for filesystem events, and changes\nto files and folders are automatically synchronized to the running\ncontainers. The synchronization is only in one direction, from this machine to\nthe device, and changes made on the device itself may be overwritten.\nThis feature requires a device running supervisor version v9.7.0 or greater.\n\nREGISTRY SECRETS \nThe --registry-secrets option specifies a JSON or YAML file containing private\nDocker registry usernames and passwords to be used when pulling base images.\nSample registry-secrets YAML file:\n```\n\t'my-registry-server.com:25000':\n\t\tusername: ann\n\t\tpassword: hunter2\n\t'': # Use the empty string to refer to the Docker Hub\n\t\tusername: mike\n\t\tpassword: cze14\n\t'eu.gcr.io': # Google Container Registry\n\t\tusername: '_json_key'\n\t\tpassword: '{escaped contents of the GCR keyfile.json file}'\n```\nFor a sample project using registry secrets with the Google Container Registry,\ncheck: https://github.com/balena-io-examples/sample-gcr-registry-secrets\n\nIf the --registry-secrets option is not specified, and a secrets.yml or\nsecrets.json file exists in the balena directory (usually $HOME/.balena),\nthis file will be used instead.\n\nDOCKERIGNORE AND GITIGNORE FILES \nBy default, the balena CLI will use a single \".dockerignore\" file (if any) at\nthe project root (--source directory) in order to decide which source files to\nexclude from the \"build context\" (tar stream) sent to balenaCloud, Docker\ndaemon or balenaEngine. In a microservices (multicontainer) fleet, the\nsource directory is the directory that contains the \"docker-compose.yml\" file.\n\nThe --multi-dockerignore (-m) option may be used with microservices\n(multicontainer) fleets that define a docker-compose.yml file. When this\noption is used, each service subdirectory (defined by the `build` or\n`build.context` service properties in the docker-compose.yml file) is\nfiltered separately according to a .dockerignore file defined in the service\nsubdirectory. If no .dockerignore file exists in a service subdirectory, then\nonly the default .dockerignore patterns (see below) apply for that service\nsubdirectory.\n\nWhen the --multi-dockerignore (-m) option is used, the .dockerignore file (if\nany) defined at the overall project root will be used to filter files and\nsubdirectories other than service subdirectories. It will not have any effect\non service subdirectories, whether or not a service subdirectory defines its\nown .dockerignore file. Multiple .dockerignore files are not merged or added\ntogether, and cannot override or extend other files. This behavior maximizes\ncompatibility with the standard docker-compose tool, while still allowing a\nroot .dockerignore file (at the overall project root) to filter files and\nfolders that are outside service subdirectories.\n\nbalena CLI v11 also took .gitignore files into account. This behavior was\ndeprecated in CLI v12 and removed in CLI v13. Please use .dockerignore files\ninstead.\n\nDefault .dockerignore patterns \nA few default/hardcoded dockerignore patterns are \"merged\" (in memory) with the\npatterns found in the applicable .dockerignore files, in the following order:\n```\n **/.git\n < user's patterns from the applicable '.dockerignore' file, if any >\n !**/.balena\n !**/.resin\n !**/Dockerfile\n !**/Dockerfile.*\n !**/docker-compose.yml\n```\nThese patterns always apply, whether or not .dockerignore files exist in the\nproject. If necessary, the effect of the `**/.git` pattern may be modified by\nadding exception patterns to the applicable .dockerignore file(s), for example\n`!mysubmodule/.git`. For documentation on pattern format, see:\n- https://docs.docker.com/engine/reference/builder/#dockerignore-file\n- https://www.npmjs.com/package/@balena/dockerignore\n\nNote: the --service and --env flags must come after the fleetOrDevice\nparameter, as per examples.",
3715
+ "description": "Build release images on balenaCloud servers or on a local mode device.\n\nBuild release images on balenaCloud servers or on a local mode device.\n\nWhen building on the balenaCloud servers, the given source directory will be\nsent to the remote server. This can be used as a drop-in replacement for the\n\"git push\" deployment method.\n\nWhen building on a local mode device, the given source directory will be\nbuilt on the device, and the resulting containers will be run on the device.\nLogs will be streamed back from the device as part of the same invocation.\nThe web dashboard can be used to switch a device to local mode:\nhttps://www.balena.io/docs/learn/develop/local-mode/\nNote that local mode requires a supervisor version of at least v7.21.0.\nThe logs from only a single service can be shown with the --service flag, and\nshowing only the system logs can be achieved with --system. Note that these\nflags can be used together.\n\nWhen pushing to a local device a live session will be started.\nThe project source folder is watched for filesystem events, and changes\nto files and folders are automatically synchronized to the running\ncontainers. The synchronization is only in one direction, from this machine to\nthe device, and changes made on the device itself may be overwritten.\nThis feature requires a device running supervisor version v9.7.0 or greater.\n\nREGISTRY SECRETS \nThe --registry-secrets option specifies a JSON or YAML file containing private\nDocker registry usernames and passwords to be used when pulling base images.\nSample registry-secrets YAML file:\n```\n\t'my-registry-server.com:25000':\n\t\tusername: ann\n\t\tpassword: hunter2\n\t'': # Use the empty string to refer to the Docker Hub\n\t\tusername: mike\n\t\tpassword: cze14\n\t'eu.gcr.io': # Google Container Registry\n\t\tusername: '_json_key'\n\t\tpassword: '{escaped contents of the GCR keyfile.json file}'\n```\nFor a sample project using registry secrets with the Google Container Registry,\ncheck: https://github.com/balena-io-examples/sample-gcr-registry-secrets\n\nIf the --registry-secrets option is not specified, and a secrets.yml or\nsecrets.json file exists in the balena directory (usually $HOME/.balena),\nthis file will be used instead.\n\nDOCKERIGNORE AND GITIGNORE FILES \nBy default, the balena CLI will use a single \".dockerignore\" file (if any) at\nthe project root (--source directory) in order to decide which source files to\nexclude from the \"build context\" (tar stream) sent to balenaCloud, Docker\ndaemon or balenaEngine. In a microservices (multicontainer) fleet, the\nsource directory is the directory that contains the \"docker-compose.yml\" file.\n\nThe --multi-dockerignore (-m) option may be used with microservices\n(multicontainer) fleets that define a docker-compose.yml file. When this\noption is used, each service subdirectory (defined by the `build` or\n`build.context` service properties in the docker-compose.yml file) is\nfiltered separately according to a .dockerignore file defined in the service\nsubdirectory. If no .dockerignore file exists in a service subdirectory, then\nonly the default .dockerignore patterns (see below) apply for that service\nsubdirectory.\n\nWhen the --multi-dockerignore (-m) option is used, the .dockerignore file (if\nany) defined at the overall project root will be used to filter files and\nsubdirectories other than service subdirectories. It will not have any effect\non service subdirectories, whether or not a service subdirectory defines its\nown .dockerignore file. Multiple .dockerignore files are not merged or added\ntogether, and cannot override or extend other files. This behavior maximizes\ncompatibility with the standard docker-compose tool, while still allowing a\nroot .dockerignore file (at the overall project root) to filter files and\nfolders that are outside service subdirectories.\n\nbalena CLI v11 also took .gitignore files into account. This behavior was\ndeprecated in CLI v12 and removed in CLI v13. Please use .dockerignore files\ninstead.\n\nDefault .dockerignore patterns \nA few default/hardcoded dockerignore patterns are \"merged\" (in memory) with the\npatterns found in the applicable .dockerignore files, in the following order:\n```\n **/.git\n < user's patterns from the applicable '.dockerignore' file, if any >\n !**/.balena\n !**/.resin\n !**/Dockerfile\n !**/Dockerfile.*\n !**/docker-compose.yml\n```\nThese patterns always apply, whether or not .dockerignore files exist in the\nproject. If necessary, the effect of the `**/.git` pattern may be modified by\nadding exception patterns to the applicable .dockerignore file(s), for example\n`!mysubmodule/.git`. For documentation on pattern format, see:\n- https://docs.docker.com/engine/reference/builder/#dockerignore-file\n- https://www.npmjs.com/package/@balena/dockerignore\n\nNote: the --service and --env flags must come after the fleetOrDevice\nparameter, as per examples.",
3740
3716
  "examples": [
3741
3717
  "$ balena push myFleet",
3742
3718
  "$ balena push myFleet --source <source directory>",
@@ -3892,6 +3868,30 @@
3892
3868
  "index.js"
3893
3869
  ]
3894
3870
  },
3871
+ "logout": {
3872
+ "aliases": [],
3873
+ "args": {},
3874
+ "description": "Logout from balena.\n\nLogout from your balena account.",
3875
+ "examples": [
3876
+ "$ balena logout"
3877
+ ],
3878
+ "flags": {},
3879
+ "hasDynamicHelp": false,
3880
+ "hiddenAliases": [],
3881
+ "id": "logout",
3882
+ "pluginAlias": "balena-cli",
3883
+ "pluginName": "balena-cli",
3884
+ "pluginType": "core",
3885
+ "strict": true,
3886
+ "enableJsonFlag": false,
3887
+ "isESM": false,
3888
+ "relativePath": [
3889
+ "build",
3890
+ "commands",
3891
+ "logout",
3892
+ "index.js"
3893
+ ]
3894
+ },
3895
3895
  "release:finalize": {
3896
3896
  "aliases": [],
3897
3897
  "args": {
@@ -4289,64 +4289,27 @@
4289
4289
  "upload.js"
4290
4290
  ]
4291
4291
  },
4292
- "support": {
4292
+ "settings": {
4293
4293
  "aliases": [],
4294
- "args": {
4295
- "action": {
4296
- "description": "enable|disable support access",
4297
- "name": "action",
4298
- "options": [
4299
- "enable",
4300
- "disable"
4301
- ]
4302
- }
4303
- },
4304
- "description": "Grant or revoke support access for devices or fleets.\n\nGrant or revoke balena support agent access to devices or fleets\non balenaCloud. (This command does not apply to openBalena.)\nAccess will be automatically revoked once the specified duration has elapsed.\n\nDuration defaults to 24h, but can be specified using --duration flag in days\nor hours, e.g. '12h', '2d'.\n\nBoth --device and --fleet flags accept multiple values, specified as\na comma-separated list (with no spaces).\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
4294
+ "args": {},
4295
+ "description": "Print current settings.\n\nUse this command to display the current balena CLI settings.",
4305
4296
  "examples": [
4306
- "balena support enable --device ab346f,cd457a --duration 3d",
4307
- "balena support enable --fleet myFleet --duration 12h",
4308
- "balena support disable -f myorg/myfleet"
4297
+ "$ balena settings"
4309
4298
  ],
4310
- "flags": {
4311
- "device": {
4312
- "char": "d",
4313
- "description": "comma-separated list (no spaces) of device UUIDs",
4314
- "name": "device",
4315
- "hasDynamicHelp": false,
4316
- "multiple": false,
4317
- "type": "option"
4318
- },
4319
- "fleet": {
4320
- "char": "f",
4321
- "description": "comma-separated list (no spaces) of fleet names or slugs (preferred)",
4322
- "name": "fleet",
4323
- "hasDynamicHelp": false,
4324
- "multiple": false,
4325
- "type": "option"
4326
- },
4327
- "duration": {
4328
- "char": "t",
4329
- "description": "length of time to enable support for, in (h)ours or (d)ays, e.g. 12h, 2d",
4330
- "name": "duration",
4331
- "hasDynamicHelp": false,
4332
- "multiple": false,
4333
- "type": "option"
4334
- }
4335
- },
4299
+ "flags": {},
4336
4300
  "hasDynamicHelp": false,
4337
4301
  "hiddenAliases": [],
4338
- "id": "support",
4302
+ "id": "settings",
4339
4303
  "pluginAlias": "balena-cli",
4340
4304
  "pluginName": "balena-cli",
4341
4305
  "pluginType": "core",
4342
4306
  "strict": true,
4343
4307
  "enableJsonFlag": false,
4344
- "authenticated": true,
4345
4308
  "isESM": false,
4346
4309
  "relativePath": [
4347
4310
  "build",
4348
4311
  "commands",
4349
- "support",
4312
+ "settings",
4350
4313
  "index.js"
4351
4314
  ]
4352
4315
  },
@@ -4485,30 +4448,89 @@
4485
4448
  "rm.js"
4486
4449
  ]
4487
4450
  },
4488
- "settings": {
4451
+ "support": {
4489
4452
  "aliases": [],
4490
- "args": {},
4491
- "description": "Print current settings.\n\nUse this command to display the current balena CLI settings.",
4453
+ "args": {
4454
+ "action": {
4455
+ "description": "enable|disable support access",
4456
+ "name": "action",
4457
+ "options": [
4458
+ "enable",
4459
+ "disable"
4460
+ ]
4461
+ }
4462
+ },
4463
+ "description": "Grant or revoke support access for devices or fleets.\n\nGrant or revoke balena support agent access to devices or fleets\non balenaCloud. (This command does not apply to openBalena.)\nAccess will be automatically revoked once the specified duration has elapsed.\n\nDuration defaults to 24h, but can be specified using --duration flag in days\nor hours, e.g. '12h', '2d'.\n\nBoth --device and --fleet flags accept multiple values, specified as\na comma-separated list (with no spaces).\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
4492
4464
  "examples": [
4493
- "$ balena settings"
4465
+ "balena support enable --device ab346f,cd457a --duration 3d",
4466
+ "balena support enable --fleet myFleet --duration 12h",
4467
+ "balena support disable -f myorg/myfleet"
4494
4468
  ],
4495
- "flags": {},
4469
+ "flags": {
4470
+ "device": {
4471
+ "char": "d",
4472
+ "description": "comma-separated list (no spaces) of device UUIDs",
4473
+ "name": "device",
4474
+ "hasDynamicHelp": false,
4475
+ "multiple": false,
4476
+ "type": "option"
4477
+ },
4478
+ "fleet": {
4479
+ "char": "f",
4480
+ "description": "comma-separated list (no spaces) of fleet names or slugs (preferred)",
4481
+ "name": "fleet",
4482
+ "hasDynamicHelp": false,
4483
+ "multiple": false,
4484
+ "type": "option"
4485
+ },
4486
+ "duration": {
4487
+ "char": "t",
4488
+ "description": "length of time to enable support for, in (h)ours or (d)ays, e.g. 12h, 2d",
4489
+ "name": "duration",
4490
+ "hasDynamicHelp": false,
4491
+ "multiple": false,
4492
+ "type": "option"
4493
+ }
4494
+ },
4496
4495
  "hasDynamicHelp": false,
4497
4496
  "hiddenAliases": [],
4498
- "id": "settings",
4497
+ "id": "support",
4499
4498
  "pluginAlias": "balena-cli",
4500
4499
  "pluginName": "balena-cli",
4501
4500
  "pluginType": "core",
4502
4501
  "strict": true,
4503
4502
  "enableJsonFlag": false,
4503
+ "authenticated": true,
4504
4504
  "isESM": false,
4505
4505
  "relativePath": [
4506
4506
  "build",
4507
4507
  "commands",
4508
- "settings",
4508
+ "support",
4509
4509
  "index.js"
4510
4510
  ]
4511
4511
  },
4512
+ "util:available-drives": {
4513
+ "aliases": [],
4514
+ "args": {},
4515
+ "description": "List available drives.\n\nList available drives which are usable for writing an OS image to.\nDoes not list system drives.",
4516
+ "flags": {},
4517
+ "hasDynamicHelp": false,
4518
+ "hiddenAliases": [],
4519
+ "id": "util:available-drives",
4520
+ "pluginAlias": "balena-cli",
4521
+ "pluginName": "balena-cli",
4522
+ "pluginType": "core",
4523
+ "strict": true,
4524
+ "enableJsonFlag": false,
4525
+ "offlineCompatible": true,
4526
+ "isESM": false,
4527
+ "relativePath": [
4528
+ "build",
4529
+ "commands",
4530
+ "util",
4531
+ "available-drives.js"
4532
+ ]
4533
+ },
4512
4534
  "tag:list": {
4513
4535
  "aliases": [],
4514
4536
  "args": {},
@@ -4729,28 +4751,6 @@
4729
4751
  "set.js"
4730
4752
  ]
4731
4753
  },
4732
- "util:available-drives": {
4733
- "aliases": [],
4734
- "args": {},
4735
- "description": "List available drives.\n\nList available drives which are usable for writing an OS image to.\nDoes not list system drives.",
4736
- "flags": {},
4737
- "hasDynamicHelp": false,
4738
- "hiddenAliases": [],
4739
- "id": "util:available-drives",
4740
- "pluginAlias": "balena-cli",
4741
- "pluginName": "balena-cli",
4742
- "pluginType": "core",
4743
- "strict": true,
4744
- "enableJsonFlag": false,
4745
- "offlineCompatible": true,
4746
- "isESM": false,
4747
- "relativePath": [
4748
- "build",
4749
- "commands",
4750
- "util",
4751
- "available-drives.js"
4752
- ]
4753
- },
4754
4754
  "whoami": {
4755
4755
  "aliases": [],
4756
4756
  "args": {},
@@ -4777,5 +4777,5 @@
4777
4777
  ]
4778
4778
  }
4779
4779
  },
4780
- "version": "23.2.1"
4780
+ "version": "23.2.2"
4781
4781
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "balena-cli",
3
- "version": "23.2.1",
3
+ "version": "23.2.2-build-renovate-major-6-github-artifact-actions-92eee38f4ad591499bc5543395d9fbc862ab0907-1",
4
4
  "description": "The official balena Command Line Interface",
5
5
  "main": "./build/app.js",
6
6
  "homepage": "https://github.com/balena-io/balena-cli",
@@ -262,6 +262,6 @@
262
262
  "balena-request": "14.0.6"
263
263
  },
264
264
  "versionist": {
265
- "publishedAt": "2025-12-02T10:31:31.412Z"
265
+ "publishedAt": "2025-12-02T12:01:01.828Z"
266
266
  }
267
267
  }