58 Commits

Author SHA1 Message Date
Leonardo Taccari
b86bd40dae doc: switch to English MDN page
Documentation is written in English, stick to also English MDN to be
consistent.
2023-10-07 19:38:18 +02:00
Roberto Abdelkader Martínez Pérez
2a47bbd43a fix: update broken links 2023-01-20 13:22:55 +01:00
Roberto Abdelkader Martínez Pérez
fe470f2328 docs: fix broken link 2021-10-29 12:28:45 +02:00
pancho horrillo
1e63f3c104 feat: Control API uses automatic cross-pinning mTLS (Closes #119)
. kapow server generates on startup a pair of certificates
that will use to secure communications to its control server.
It will communicate the server and client certificates as well
as the client private key to the init programs it launches,
via environment variables.

. kapow server now understands a new flag --control-reachable-addr
which accepts either a IP address or a DNS name, that can be used
to ensure that the generated server certificate will be appropiate
in case the control server must be accessed from something other
than localhost.

Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2021-03-12 17:24:17 +01:00
Roberto Abdelkader Martínez Pérez
0ffb28c3d6 chore: test documentation (#145)
* chore: Test documentation

* docs: fix broken links
2020-12-30 16:59:22 +01:00
pancho horrillo
26fa12c871 doc: drop mentions to .pow files ($deity REST their soul)
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2020-12-24 14:03:49 +01:00
Héctor Hurtado
eb4dbeadb9 Add references to mTLS configuration of proposed servers.
Fixes #100
2020-08-24 12:44:19 +02:00
Héctor Hurtado
d0e08815f7 Add example documentation to use built in HTTPS/mTLS support 2020-08-18 13:07:47 +02:00
pancho horrillo
a311da0d87 doc: drop shebang lines in .pow files
For now, Kapow! treats .pow files as shell scripts, not executables.
See https://github.com/BBVA/kapow/issues/62
2020-06-11 20:04:11 +02:00
pancho horrillo
77b358e3c8 doc: style fixes 2020-06-11 19:48:47 +02:00
pancho horrillo
09b6d54487 doc: wording and style fixes 2020-06-11 19:45:57 +02:00
Roberto Abdelkader Martínez Pérez
a178d19360 doc: Debugging bash example 2020-04-22 10:26:29 +02:00
Héctor Hurtado
45a577a547 Fix typo in documentation 2020-04-21 10:40:36 +02:00
Héctor Hurtado
1e276ab4cf Complete documentation with an explanation of set -x in script tricks 2020-04-20 10:38:54 +02:00
Héctor Hurtado
248f7d1fcc Added stderr output management to jaillover.
Added Spawn support for stderr redirection.
Added --debug option to server cmd.
Added debug information to documentation.
Finnished script logger.
2020-04-20 10:18:16 +02:00
pancho horrillo
4b82a2e418 docs: style fixes 2020-02-24 15:13:53 +01:00
César Gallego Rodríguez
42329a6f56 kapow! tidy server example 2020-02-24 14:56:21 +01:00
Roberto Abdelkader Martínez Pérez
64653d6d79 doc: Examples of running Kapow! behind a proxy with HTTPS. Closes #100. 2019-12-20 12:43:07 +01:00
Roberto Abdelkader Martínez Pérez
3cfc7e21ba doc: Put examples into categories. Parameter injection example moved to security concerns instead (#101) 2019-12-19 16:32:56 +01:00
Roberto Abdelkader Martínez Pérez
01726df4e8 doc: Restructure to allow better latex rendering 2019-12-16 11:00:36 +01:00
pancho horrillo
3bb0205ad1 doc: style fixes 2019-12-13 15:14:35 +01:00
pancho horrillo
2847073519 doc: drop explicit :tech: role 2019-12-13 15:10:17 +01:00
pancho horrillo
dea72cbe3a doc: style fixes and links 2019-12-13 15:08:02 +01:00
pancho horrillo
45de5a55e8 doc: style fixes 2019-12-13 12:35:48 +01:00
pancho horrillo
b9f42bc458 doc: fix code style in titles
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 18:18:05 +01:00
pancho horrillo
f57df90347 doc: fix broken link
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 18:17:46 +01:00
pancho horrillo
e78af66c12 doc: markup ping as command role, not program role
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 17:56:28 +01:00
pancho horrillo
ecaea23d40 doc: markup stdin as tech role
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 16:05:55 +01:00
pancho horrillo
ab615e2276 doc: markup :any: role as default role, which is now :tech: (custom)
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 15:59:27 +01:00
pancho horrillo
cb5ba7db43 doc: markup {User,Control,Data} HTTP Interface as role any
Also markup localhost:8080 as code, for consistency.

Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 14:41:14 +01:00
pancho horrillo
11383d456a doc: markup JSON as any role (part II)
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 13:17:55 +01:00
pancho horrillo
1cb328646e doc: markup ping as program role
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 12:16:41 +01:00
pancho horrillo
8742ee9667 doc: markup ls as command role
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 11:44:32 +01:00
pancho horrillo
45de867b2d doc: markup jq as program role
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 11:43:04 +01:00
pancho horrillo
4d2f0af941 doc: markup curl as program role
See ¹.

¹: https://www.sphinx-doc.org/en/1.5/markup/inline.html#role-program

Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-11 11:43:04 +01:00
pancho horrillo
e6cb0f1fa6 doc: fix typo and rst style fixes
As per the official docs¹, we should use ``code`` instead of :samp:`code`,
since we are not enhancing variables inside.

:samp:
A piece of literal text, such as code. Within the contents, you can use curly
braces to indicate a “variable” part, as in file. For example, in :samp:`print
1+{variable}`, the part variable would be emphasized.

If you don’t need the “variable part” indication, use the standard ``code``
instead.

¹: https://www.sphinx-doc.org/en/1.5/markup/inline.html#role-samp
2019-12-11 02:37:56 +01:00
pancho horrillo
37025211b1 doc: style fixes 2019-12-11 02:06:31 +01:00
pancho horrillo
ef838c4a25 doc: style fix 2019-12-10 18:23:23 +01:00
pancho horrillo
ba6006fdf5 doc: fix typo 2019-12-10 18:15:29 +01:00
pancho horrillo
a9328fe706 doc: consistent naming of pow files 2019-12-10 18:10:31 +01:00
Roberto Abdelkader Martínez Pérez
84e481f78f Fix nonworking examples 2019-12-10 15:13:29 +01:00
Roberto Abdelkader Martínez Pérez
62570048af Use tabs in HEREDOC blocks 2019-12-10 14:43:51 +01:00
pancho horrillo
bb4aa1a00f doc: normalize style of Kapow!, to be shown italicized
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-10 10:34:39 +01:00
Roberto Abdelkader Martínez Pérez
27569cf50c Review examples against option substitution.
Co-authored-by: pancho horrillo <pedrofelipe.horrillo@bbva.com>
2019-12-10 09:11:57 +01:00
pancho horrillo
166c767317 doc: add section on security and misc fixes
Co-authored-by: Roberto Abdelkader Martínez Pérez <robertomartinezp@gmail.com>
2019-12-05 18:30:35 +01:00
pancho horrillo
8248627f04 doc: misc fixes
Co-authored-by: Luis Saiz <luis.saiz@bbva.com>
2019-11-29 12:57:45 +01:00
luissaiz
b0c8b74e63 Update index.rst (#97) 2019-11-29 11:56:14 +01:00
pancho horrillo
53b326cb7b doc: style fixes, example code fixes and clarifications 2019-11-27 16:07:23 +01:00
pancho horrillo
530fad17c9 doc: fix typo 2019-11-27 07:53:56 +01:00
cr0hn
cfbb2ef6cb Merged greet-json & upload examples 2019-11-22 12:15:33 +01:00