@toa.io/cli 1.1.0-dev.10 → 1.1.0-dev.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/cli",
-  "version": "1.1.0-dev.10",
+  "version": "1.1.0-dev.12",
   "description": "Toa CLI",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -23,12 +23,12 @@
   },
   "dependencies": {
     "@toa.io/console": "0.6.0",
-    "@toa.io/generic": "0.11.0-dev.10",
-    "@toa.io/kubernetes": "0.7.5-dev.10",
-    "@toa.io/norm": "1.0.2-dev.10",
-    "@toa.io/yaml": "0.7.6-dev.10",
+    "@toa.io/generic": "0.11.0-dev.12",
+    "@toa.io/kubernetes": "0.7.5-dev.12",
+    "@toa.io/norm": "1.0.2-dev.12",
+    "@toa.io/yaml": "0.7.6-dev.12",
     "find-up": "5.0.0",
     "yargs": "17.6.2"
   },
-  "gitHead": "df6df35ff3e9f2d9416118a979d3885a8a1cd897"
+  "gitHead": "e80500549e76c0e35407a4b3af5a5a38a4e33686"
 }

package/readme.md

@@ -57,9 +57,10 @@ the context will be found and replayed sequentially.
 <code>--error</code> print errors only<br/>
 </dd>
 </dl>
-## Deployment
 
-> Deployment commands use current `kubectl` context.
+## Operations
+
+> Commands use current Kubernetes context.
 
 ### deploy
 
@@ -74,15 +75,8 @@ the context will be found and replayed sequentially.
 ### conceal
 
 <dl>
-<dt>
-<code>toa conceal</code>
-</dt>
-<dd>Deploy new declared secrets.
-
-<code>--reset</code> don't skip already deployed</dd>
-
 <dt><code>toa conceal &lt;secret&gt; &lt;key&gt; &lt;value&gt;</code></dt>
-<dd>Deploy a <code>key</code> with a <code>value</code> to a <code>secret</code>.</dd>
+<dd>Deploy a <code>key</code> with a <code>value</code> to a secret named <code>toa-{secret}</code>.</dd>
 </dl>
 
 ### reveal
@@ -93,3 +87,21 @@ the context will be found and replayed sequentially.
 </dt>
 <dd>Print keys and values of a secret.</dd>
 </dl>
+
+### shell
+
+<dl>
+<dt>
+<code>toa shell [image]</code>
+</dt>
+<dd>Run interactive shell inside a disposable pod.
+
+<code>image</code> docker image<br/>
+</dd>
+</dl>
+
+Extra arguments can be passed:
+
+```shell
+$ toa shell -- ping 1.1
+```

package/src/commands/shell.js

@@ -0,0 +1,22 @@
+'use strict'
+
+const { shell } = require('../handlers/shell')
+
+const builder = (yargs) => {
+  yargs
+    .positional('image', {
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Docker image',
+      default: 'alpine'
+    })
+    .example([
+      ['$0 shell'],
+      ['$0 shell -- ping localhost']
+    ])
+}
+
+exports.command = 'shell [image]'
+exports.desc = 'Run interactive shell from the current Kubernetes context'
+exports.builder = builder
+exports.handler = shell

package/src/handlers/shell.js

@@ -0,0 +1,29 @@
+'use strict'
+
+const { spawn } = require('node:child_process')
+const { newid } = require('@toa.io/generic')
+
+const shell = async (argv) => {
+  const rnd = newid().substring(0, 6)
+
+  const args = [
+    'run',
+    'shell-' + rnd,
+    '--rm',
+    '-i',
+    '--tty',
+    '--image',
+    argv.image,
+    '--restart=Never',
+    '--'
+  ]
+
+  const extra = argv._.splice(1)
+
+  if (extra.length > 0) args.push(...extra)
+  else args.push('sh')
+
+  await spawn('kubectl', args, { stdio: 'inherit' })
+}
+
+exports.shell = shell