Paulo Castro
ea89a6f221
Update documentation markdown following v11-meta branch rebase
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-06-04 13:51:58 +01:00
Cameron Diver
64c2f00d2a
Update balena ssh command to support local devices and multicontainer
...
Change-type: major
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-06-04 13:51:57 +01:00
Alexis Svinartchouk
c49a1d3fbf
Remove --dockerPort's -p alias for balena preload
...
It was conflicting with --pin-device-to-release -p alias
Changelog-entry: Remove --dockerPort's -p alias for `balena preload`
Change-type: major
2019-06-04 13:51:56 +01:00
Paulo Castro
abf573fa47
Begin the transition to oclif with 'balena env add' (fix dropped leading
...
zero in device UUID).
This commit is fairly chunky because it adds the oclif dependency for
the first time, and refactors the CLI help and docs generation code to
accommodate both Capitano and oclif.
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-06-04 13:51:56 +01:00
Paulo Castro
a4efc7c9c4
Fix CI build error (missing @types/mz)
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-05-30 12:57:03 +01:00
Cameron Diver
f77156772a
Add the ability to specify an environment variable when pushing to local
...
mode device
Closes : #1255
Change-type: minor
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-05-27 13:23:55 +01:00
Alexis Svinartchouk
9434570c2d
Improve preload's --commit parameter description
...
Change-type: patch
2019-05-22 17:29:08 +02:00
Alexis Svinartchouk
2091768c84
Rename preload --commit latest
to preload --commit current
...
`latest` is still supported
Change-type: patch
2019-05-21 18:00:01 +02:00
Thodoris Greasidis
9f15ee58df
docs: Fix os configure example in os build-config docs
...
Connects-to: #1231
Change-type: patch
Signed-off-by: Thodoris Greasidis <thodoris@balena.io>
2019-05-16 12:38:44 +03:00
Paulo Castro
3303ac21c9
Update README and INSTALL docs (review typos and some rewording)
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-05-01 18:15:47 +01:00
Paulo Castro
2ad0b60aeb
Unify the CLI instructions between capitanodoc.ts and README.md, move
...
the installation instructions to INSTALL.md, and update the markdown
generation scripts.
Change-type: minor
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-04-29 14:27:32 +01:00
Cameron Diver
1b13d1b969
Allow specifying a .local address for logs and push
...
Change-type: minor
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-25 11:00:45 +01:00
Cameron Diver
a6d2950260
Allow filtering of system logs with push and logs commands
...
Change-type: minor
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-24 17:30:18 +01:00
Cameron Diver
56c74af1ff
Add per-service filtering to logs and push
...
Change-type: minor
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-24 15:05:05 +01:00
Cameron Diver
97c15208b5
push: Add detached flag to avoid streaming logs after local push
...
Change-type: minor
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-24 14:31:30 +01:00
Cameron Diver
f816cb4ce8
Fix and update log documentation
...
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-24 13:04:49 +01:00
Cameron Diver
d412d39164
Add ability to use balena logs with a local mode device
...
Change-type: patch
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-24 12:48:52 +01:00
Paulo Castro
db25a65753
Add --dockerfile option to the build, deploy and push commands
...
It allows the selection of an alternative Dockerfile in single-
container projects that do not include a docker-compose file.
Change-type: minor
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-04-23 15:34:19 +01:00
Cameron Diver
7c71098d86
Update livepush documentation and required versions
...
Change-type: patch
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-23 14:00:05 +01:00
Cameron Diver
6a9a9e1fdb
Add livepush ability to balena push
...
Change-type: minor
Signed-off-by: Cameron Diver <cameron@balena.io>
2019-04-23 14:00:04 +01:00
Paulo Castro
29dd5e71a1
Fix docs markdown (deprecation messages for 'local push' and 'sync')
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-04-13 16:23:06 +01:00
Paulo Castro
30698c62e3
Remove 'quickstart' command and deprecate 'local push'.
...
Change-type: major
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-04-03 17:34:55 +01:00
Gergely Imreh
b4439b7d78
ssh: add --noninteractive
flag not to suggest devices to connect to
...
The suggestion happens if the UUID supplied is not found. Because
of that function, it's impossible to do an atomic connect to a device
in non-interactive mode. The auto-suggestion results connecting to
the first available device, which is likely not the intended action.
The current workaround is running a `balena device UUID` and check
its exit code before running `balena ssh UUID`, but since these
are independent steps, still can connect to another device, if between
the two commands anything changes. With this flag used, one could never
connect accidentally to the wrong device due to suggestions.
Change-type: minor
Signed-off-by: Gergely Imreh <gergely@balena.io>
2019-03-12 11:50:17 +00:00
Gergely Imreh
a5cfbb3181
ssh: correct the minimum OS version that allows host OS connection
...
Since openBalena API v0.11.0 (downstream API 9.16.0) the minimum
OS version has been lowered from 2.7.5 to 2.0.0 for host OS access.
Change-type: patch
Signed-off-by: Gergely Imreh <imrehg@gmail.com>
2019-03-11 15:24:12 +00:00
Paulo Castro
de3837f777
Minor doc updates (add DEBUG hint)
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-03-04 19:53:18 +00:00
Paulo Castro
05e80094de
Add registry-secrets help msg for build and deploy commands
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-02-27 21:58:44 +00:00
Paulo Castro
211fb824a1
Extend private registry support to balena build and deploy commands
...
Resolves : #1116
Change-type: minor
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-02-27 13:16:09 +00:00
Chris Crocker-White
67673a55f7
Fix regression in ee75ff and restore functionality to ToC in docs
...
Change-type: patch
Signed-off-by: Chris Crocker-White <chriscw@balena.io>
2019-02-22 16:37:57 +00:00
Paulo Castro
24fdfc9aef
Update 'balena help local flash' documentation re zipped images
...
Change-type: patch
Signed-off-by: Paulo Castro <paulo@balena.io>
2019-01-17 17:52:28 +00:00
Matthew McGinn
10fff8f0f5
Merge branch 'master' of github.com:balena-io/balena-cli into typo
2018-12-31 08:22:32 -05:00
Trevor Sullivan
64ec151e4b
Added documentation about the dependencies required to build balena-cli
...
Change-type: minor
Signed-off-by: Trevor Sullivan <trevor@balena.io>
2018-12-28 13:00:43 -08:00
Matthew McGinn
3e4e661b28
Fix up small docs typo
...
Change-type: patch
Signed-off-by: Matthew McGinn <mamcgi@gmail.com>
2018-12-28 08:40:18 -05:00
Paulo Castro
0f302d30ec
Add push --registry-secrets option for private docker registry authentication
...
Change-type: minor
Signed-off-by: Paulo Castro <paulo@balena.io>
2018-12-18 00:01:15 +00:00
Thodoris Greasidis
853d146457
Update the os configure examples to better explain --device-type
...
Signed-off-by: Thodoris Greasidis <thodoris@balena.io>
2018-12-14 15:46:27 +02:00
Thodoris Greasidis
1e5cf8655e
actions: Add resource tag operations
...
Resolves : #866
HQ: https://github.com/resin-io/hq/issues/150
HQ: https://github.com/resin-io/hq/pull/281
Change-type: minor
Signed-off-by: Thodoris Greasidis <thodoris@balena.io>
2018-12-10 23:05:48 +02:00
Cameron Diver
a357405f3a
Make architecture checking more stringent when installing emulators
...
Also change the documentation to an armv7hf.
Change-type: patch
Signed-off-by: Cameron Diver <cameron@balena.io>
2018-12-03 13:10:54 +00:00
Thodoris Greasidis
5abd240d50
actions/config: Fix examples to include --version as required
...
Connects-to: #1007
Change-type: patch
Signed-off-by: Thodoris Greasidis <thodoris@balena.io>
2018-11-23 16:01:01 +02:00
Akis Kesoglou
8291c96e69
Make specifying the version during configuration optional
...
`version` used to be optional but it seems we recently had to make it a required parameter. However it really feels redundant when all it’s used for is to determine whether the command should issue a legacy user API key or a provisioning key.
This makes version optional but tries to figure it out by itself by reading os-release from the image's boot partition. This is not foul-proof however, and while it'll work with most recent images it won't work with all and in that case it'll bail out and only then warn the user to specify it via the --version argument.
Change-type: minor
2018-11-16 19:39:43 +02:00
Akis Kesoglou
6e36cd139a
Include join
and leave
commands in API documentation
...
Change-type: patch
2018-11-16 16:02:43 +02:00
Tim Perry
a809847d60
Mark api keys in the CLI as non-experimental
...
After the recent SDK updates, they should now work everywhere
Change-type: patch
2018-11-07 16:30:56 +01:00
Tim Perry
dc6cde2cf1
Change env var commands to set app-wide env vars, using the new SDK
...
Change-type: major
2018-10-29 22:29:03 +01:00
Tim Perry
4907fccf48
Rename everything from 'resin' to 'balena'
...
Change-type: major
2018-10-29 22:29:02 +01:00
Thodoris Greasidis
4d42f74c0c
Add support for the Opensource provisioning flow
...
Connects-to: #978
Change-type: major
Depends-on: https://github.com/resin-io/resin-sdk/pull/594
HQ: https://github.com/resin-io/balena/pull/1140
Signed-off-by: Thodoris Greasidis <thodoris@resin.io>
2018-10-29 22:29:02 +01:00
Heds Simons
bf71f9ea16
Merge pull request #981 from resin-io/local-mode-v2
...
Local mode v2
2018-10-19 17:09:28 +02:00
Cameron Diver
947f91d570
Support multicontainer local mode in resin push
...
Change-type: minor
Signed-off-by: Cameron Diver <cameron@resin.io>
2018-10-19 16:44:56 +02:00
Alexis Svinartchouk
0c1c108b2b
Check for correct architecture when preloading, instead of correct device type
...
Preload will now propose to preload any app that matches the image
architecture.
Change-type: major
Signed-off-by: Alexis Svinartchouk <alexis@resin.io>
2018-10-19 16:43:02 +02:00
Tim Perry
8df066df12
Fix formatting of preload examples
...
Based on https://github.com/resin-io/docs/pull/915 from @drjasonharrison-vp-eio
Change-type: patch
Signed-off-by: Tim Perry <tim@resin.io>
2018-10-03 15:31:24 +02:00
Tim Perry
8688eb5da0
Include --emulated in the example resin build parameters
...
Change-type: patch
Signed-off-by: Tim Perry <tim@resin.io>
2018-09-19 15:34:29 +02:00
Theodor Gherzan
3b283d4a98
Device api keys are no longer used in the registration process
...
Change-type: patch
Signed-off-by: Theodor Gherzan <theodor@resin.io>
2018-09-10 12:30:51 +01:00
Cameron Diver
e7c68c1a5c
Support emulated and nocache options for remote builds
...
Change-type: minor
Closes : #901
Signed-off-by: Cameron Diver <cameron@resin.io>
2018-08-09 14:36:34 +01:00
Tim Perry
392cd8569f
Make build trigger hash examples clearer
...
Signed-off-by: Tim Perry <tim@resin.io>
2018-08-09 11:47:21 +02:00
Tim Perry
e32eda26d9
Update .resin-sync.yml docs for local push and include example env vars
...
Change-type: patch
Signed-off-by: Tim Perry <tim@resin.io>
2018-08-09 11:21:45 +02:00
Tim Perry
36eb0a108e
Post-review tweaks to OS actions
2018-07-13 19:34:59 +02:00
Tim Perry
0bf6fb1739
Add --version options to os configure & config generate
...
This is used to ensure the correct type of API key is used in all
configuration.
Change-Type: patch
2018-07-13 19:34:59 +02:00
Tim Perry
f9cf0aaf23
Remove a couple of artifacts of the pubnub logs implementation
2018-07-12 15:10:16 +02:00
Tim Perry
52f93f8f12
Add --generate-device-api-key parameter to config generate
...
Change-Type: minor
2018-07-10 19:57:56 +02:00
Tim Perry
8c74f784f7
Make sure 'resin push' is included in the docs
...
Fixes #906
Change-Type: patch
2018-06-26 19:00:20 +02:00
Cameron Diver
1a48fed1f7
Support pinned release preloading
...
Change-type: minor
Closes : #886
Signed-off-by: Cameron Diver <cameron@resin.io>
2018-06-13 12:29:30 +01:00
Tim Perry
da8483e6a6
Add a multicontainer caveat to the env var commands
...
Change-Type: patch
2018-06-01 12:37:29 +02:00
Tim Perry
834a2f1e4d
Warn user that api keys will not be shown again in future
2018-04-11 19:31:03 +02:00
Tim Perry
59d4890eae
Add 'api-key generate' command
...
Change-Type: minor
2018-04-10 19:21:37 +02:00
Tim Perry
12a1916007
Allow (experimental!) login with API keys
...
Change-Type: minor
2018-03-29 11:11:25 +02:00
Zach Walchuk
ee75ff2753
Remove explicit anchor links in CLI docs
...
Our docs markdown renderer doesn't process explicit anchor tags, as it generates its own. The script that generates the markdown has been updated to not include these tags and to properly build the TOC links.
Change-type: patch
2018-03-20 13:10:07 -05:00
Tim Perry
6ee36cb5c7
Generate consistent working anchors for both our md output & resin docs
...
Change-Type: patch
2018-03-15 11:40:29 +01:00
Tim Perry
d9906121e1
Update full CLI docs with recent installation improvements too
...
Change-Type: patch
2018-03-12 22:17:20 +01:00
Akis Kesoglou
14a3f51b73
Add docker-compose-aware builds and deployments
...
Legacy behaviour is mostly retained. The most notable change in behaviour is that invoking `resin deploy` without options is now allowed (see help string how it behaves).
In this commit there are also the following notable changes:
- Deploy/Build are promoted to primary commands
- Extracts QEMU-related code to a new file
- Adds a utility file to retrieve the CLI version and its parts
- Adds a helper that can be used to manipulate display on capable clients
- Declares several new dependencies. Most are already indirectly installed via some dependency
Change-Type: minor
2018-03-07 14:48:05 +00:00
Alexis Svinartchouk
f698f561c9
Multicontainer preload: Update resin-preload to 6.0.0-beta4
...
Change-Type: minor
2018-03-07 14:46:35 +00:00
MoranF
33fd70291a
Add 'or mounted resinOS image'
...
Connects-To: #764
Change-Type: patch
2018-01-30 17:30:18 +01:00
Tim Perry
f25442c036
Move documentation generation to TypeScript
...
Change-Type: patch
2018-01-09 17:14:49 +01:00
Andreas Fitzek
0653769156
fixed example
2017-12-18 17:03:16 +01:00
Andreas Fitzek
3ed319872a
refactored
2017-12-18 17:03:16 +01:00
Andreas Fitzek
ee124671d8
mention Resin OS version requirement
2017-12-18 17:03:16 +01:00
Andreas Fitzek
1b4dabd37c
Add ssh option for direct host OS access
...
Use the `--host` (short `-H`) option in the ssh command to access
the host OS of the device.
Direct host OS is enabled for devices with Resin OS >= 2.7.5.
Change-Type: minor
Connects-To: #736
Signed-off-by: Andreas Fitzek <andreas@resin.io>
2017-12-18 17:03:16 +01:00
Tim Perry
e38a0c0047
Allow os configure
to configure for an app, not just a specific device
...
This moves to --app and --uuid options, and deprecates the previous
format, but doesn't immediately remove it so this is not a breaking
change.
Connects-To: #691
Change-Type: minor
2017-11-16 19:51:34 +01:00
Tim Perry
eef0d9cdbe
Print help even for expected errors
...
Change-Type: patch
2017-11-16 19:51:17 +01:00
Tim Perry
08c40195e5
Make sure everything uses the same shared deviceApiKey option
2017-11-16 19:09:20 +01:00
Tim Perry
87f46cb957
Allow non-interactice config generate for simple network settings
...
Fixes #695
Fixes #410
Change-Type: minor
2017-11-16 15:04:58 +01:00
Tim Perry
1fafe64579
Remove resin promote command (which has never worked) to wait for larger resinOS provisioning updates
...
This would be a major change if the command was ever successful, but it
appears it hasn't ever worked for any available published version of
ResinOS, so it's not possible that there are users relying on it.
Change-Type: patch
2017-11-15 14:46:22 +01:00
Alexis Svinartchouk
eef192ff68
Allow preloading jetson-tx2 images, improve flasher images detection and remove the --dont-detect-flasher-type-images option.
...
* update resin-preload to 5.0.0
Connects-To: #705
Change-Type: minor
2017-10-27 12:14:27 +02:00
Tim Perry
dfd8b6717d
Add preload to the CLI docs
...
Change-Type: patch
2017-10-25 13:17:07 +02:00
Tim Perry
2d43e47610
Add device api keys warning on device register and os configure
2017-10-18 13:43:16 +02:00
Tim Perry
8e95757f47
Make resin config generate
safe for all ResinOS versions
2017-10-18 13:43:16 +02:00
Pagan Gazzard
3fd4f328ab
Added a device api key parameter to the os configure
command.
...
Change-Type: minor
2017-10-18 13:43:16 +02:00
Pagan Gazzard
97eaf174ec
Added a --device-api-key
option to the config generate
command.
...
Change-Type: minor
2017-10-18 13:43:16 +02:00
Pagan Gazzard
2ef56a9a3f
Added a --device-api-key
option to the device register
command.
...
Change-Type: minor
2017-10-18 13:43:16 +02:00
Tim Perry
82888de036
Document how to resin deploy
to an app as a collaborator
...
Change-Type: patch
2017-10-13 16:13:46 +02:00
Jacinto Arias
bea7b2035a
Added --squash option to resin build command
2017-06-26 13:33:50 +02:00
Eugene Mirotin
8bdacbb11e
dedupe the shared options
2017-06-15 16:43:12 +03:00
Eugene Mirotin
d2a9aee685
improve available drives listing
...
make the config a path to the file and not the stringified JSON
2017-06-15 16:43:02 +03:00
Eugene Mirotin
77a4c6fdc2
move available-drives command to util
2017-06-15 16:43:02 +03:00
Eugene Mirotin
4d935d62fc
improve wording
2017-06-15 16:42:46 +03:00
Eugene Mirotin
5c5cfde49f
automated init doc
2017-06-15 16:39:55 +03:00
Eugene Mirotin
4ac8cb1003
rebuild docs
2017-06-15 16:39:55 +03:00
Tim Perry
66a4faeea5
Small improvement to resin deploy docs
...
Change-Type: patch
2017-06-15 12:36:40 +02:00
Cameron Diver
f2862f7fe2
Add emulated build option to resin build
...
This commit adds the ability to run a Docker build for an architecture
which is not the host architecture, using qemu-linux-user. Currently
this is only supported for linux.
Added:
* Installation of qemu which supports propagated execve flags
* Copying of qemu binary into the build context
* Transposing the given Dockerfile to use the qemu binary
* Intercepting of the build stream, so the output looks *almost* exactly
the same.
Change-type: minor
Signed-off-by: Cameron Diver <cameron@resin.io>
2017-06-14 12:06:03 +01:00
Gergely Imreh
974be5cc13
resin build: fix mismatch in command line argument signature
...
The command line arg was taking `devicetype`, but the rest of the code
uses `deviceType`. Thus it was impossible to specify a device type
in practice to build a `Dockerfile.template`.
Change-type: patch
Signed-off-by: Gergely Imreh <imrehg@gmail.com>
2017-05-30 10:34:32 +01:00
Eugene Mirotin
6ae59654a0
fix
2017-05-19 01:44:30 +03:00
Eugene Mirotin
b88f7a993c
escape params
2017-05-19 01:25:01 +03:00
Tim Perry
6e5e4bd8a6
Get docs and the code generating them back in sync (from #515 , #508 )
2017-05-12 12:01:37 +02:00
craig-mulligan
029b7c7164
Add note on how to get resin device types
...
Connects to #507
Change-Type: patch
2017-05-01 17:14:58 +01:00