teuton 2.1.8 → 2.1.9

data/docs/changelog/todo.md

@@ -1,46 +0,0 @@
-
-# TO-DO list
-
-List of things to do, classified into 3 sections:
-* (A) I know read and write.
-* (B) I work as IT teacher
-* (C) I want to program ruby language
-
-> I write this list without any criteria.
-> Only an unordered list of interesting/usefull things to be done.
-
-## Section A
-
-Documentation
-
-* Revise Spanish docs (ES - Mejorar la documentación en español)
-* Revise English documents. Update english version with changes done into spanish version.
-* Make videos showing how to use this tool
-    * Video about download and install this tool
-    * Test installation scripts
-    * Vídeo with Windows installation.
-    * Video using examples 01 to 05...
-* Write a special documentation for novice
-
-## Section B
-
-* Create your own (simple or complex) educational test.
-* Upload your own educational test to this repository.
-
-## Section C
-
-* `goto :host1, :puppet => "Puppet instructions"`
-* `goto :host1, :chef => "Chef instructions"`
-* `result.test("...")`
-* `send :email_to => :members_emails`
-
-Gamification
-* When students demand help they could recibe some advises.
-* Define a loop of executions of our activity. For example:
-  every 5 minutes, run the activity, and repeat this 10 times.
-  `start :times=>10, :duration=>5 do`      
-* More ideas: bonus, lives, etc.
-
-Create 2 evaluation modes:
-1. Evaluate targets (current mode): `start :score=>:targets do ...`
-1. Evaluate task: `start :score=>:tasks do ...`

data/docs/commands/create_skeleton.md

@@ -1,31 +0,0 @@
-
-# Create skeleton
-
-Create skeleton for a new "foo" project: `teuton create foo`
-
-## Execution
-
-```bash
-$ teuton create foo
-
-[INFO] Create project <foo>
-* Create dir        => foo
-* Create dir        => foo/assets
-* Create file       => foo/start.rb
-* Create file       => foo/config.yaml
-* Create file       => foo/.gitignore
-* Create file       => foo/README.md
-```
-
-## Skeleton
-
-This command will create:
-
-| File/Directory  | Description    |
-| --------------- | -------------- |
-| foo             | Base directory |
-| foo/assets      | Base directory for other resources (images and text files) |
-| foo/start.rb    | Main Script    |
-| foo/config.yaml | YAML configuration file |
-| foo/.gitignore  | Prevent uploading YAML files to git repository |
-| foo/README.md   | Statement of our practice |

data/docs/commands/help.md

@@ -1,13 +0,0 @@
-Running `teuton` without params will show you usage information:
-
-```bash
-$ teuton
-Commands:
- teuton [play] [--export=FORMAT] DIRECTORY  # Run challenge from directory
- teuton create DIRECTORY                    # Create skeleton for a new project
- teuton download                            # Download Teuton challenges from git repo
- teuton help [COMMAND]                      # Describe available commands or one specific command
- teuton test DIRECTORY                      # Check challenge contents
- teuton update                              # Update TEUTON from git repo
- teuton version                             # Show the program version
-```

data/docs/commands/revise_test.md

@@ -1,46 +0,0 @@
-
-# Revise Test Unit
-
-## Example 01
-
-Revising Test Unit called `learn\learn-01-target`:
-
-```bash
-$ teuton test learn/learn-01-target
-[INFO] ScriptPath => /home/david/proy/repos/teuton.d/challenges/learn/learn-01-target/start.rb
-[INFO] ConfigPath => /home/david/proy/repos/teuton.d/challenges/learn/learn-01-target/config.yaml
-[INFO] TestName   => learn-01-target
-
-+------------------------+
-| GROUP: learn-01-target |
-+------------------------+
-(001) target      Create user <david>
-     weight      1.0
-     goto        localhost and {:exec=>"id david"}
-     expect      david (String)
-
-+--------------+-------+
-| DSL Stats    | Count |
-+--------------+-------+
-| Groups       | 1     |
-| Targets      | 1     |
-| Goto         | 1     |
-|  * localhost | 1     |
-| Uniques      | 0     |
-| Logs         | 0     |
-|              |       |
-| Gets         | 0     |
-| Sets         | 0     |
-+--------------+-------+
-+----------------------+
-| Revising CONFIG file |
-+----------------------+
-[WARN] File /home/david/proy/repos/teuton.d/challenges/learn/learn-01-target/config.yaml not found!
-[INFO] Recomended content:
----
-:global:
-:cases:
-- :tt_members: VALUE
-```
-
-Notice that this Test Unit hasn't config file, and Teuton suggests us content for our config.file. But it isn't necessary for this example.

data/docs/commands/run_test_unit.md

@@ -1,78 +0,0 @@
-
-# Run Test Unit
-
-We use `teuton play` command to run a Test Unit (or challenge).
-
-This command executes challenge (Test Unit) from specified directory. By default, show progress on the screen.
-
-## Help
-
-Run `teuton help play` to see help.
-
-Usage:
-* teuton [play] [OPTIONS] DIRECTORY
-
-Options:
-* [--export=EXPORT], select output format.
-* [--cname=CNAME], select other config file name.
-* [--cpath=CPATH], select absolute path to config file.    
-* [--case=CASE], select cases to be tested.      
-
-## Usage
-
-| ID | Command              | Descriptiont |
-| -- | -------------------- | ------------ |
-| 01 | teuton foo           | Run foo/start.rb, with config file foo/config.yaml |
-| 02 | teuton play foo      | Run foo/start.rb, with config file foo/config.yaml |
-| 03 | ruby teuton foo      | Same as 01 on Windows OS |
-| 04 | ruby teuton play foo | Same as 02 on WIndows OS |
-| 05 | teuton . | Run ./start.rb with ./config.yaml file |
-| 06 | teuton play --export=json foo | Run foo/start.rb and force json format during exporting. Others output formats availables are: txt, colored_text, json, yaml |
-| 07 | teuton play --cname=class foo | Run foo/start.rb with foo/class.yaml config file |
-| 08 | teuton foo/demo42.rb | Run foo/demo42.rb with foo/demo42.yaml config file |
-| 08 | teuton play --cpath=current/class.yaml foo | Run foo/start.rb with current/class.yaml config file |
-| 10 | teuton play --case=6,16 foo | Run foo/start.rb with foo/config.yaml config file but only for case id 6 and 16 |
-
----
-
-## Example
-
-Running example 01:
-
-```bash
-$ teuton learn/learn-01-target
-[INFO] ScriptPath => /home/david/proy/repos/teuton.d/challenges/learn/learn-01-target/start.rb
-[INFO] ConfigPath => /home/david/proy/repos/teuton.d/challenges/learn/learn-01-target/config.yaml
-[INFO] TestName   => learn-01-target
-
-==================================
-Executing [teuton] (version 2.1.0)
-[INFO] Running in parallel (2019-10-04 23:44:19 +0100)
-Starting case <anonymous>
-* Processing <learn-01-target> .
-
-[INFO] Duration = 0.006568696 (2019-10-04 23:44:19 +0100)
-==================================
-
-INITIAL CONFIGURATIONS
-+---------------+-------------------------------------------------------+
-| tt_title      | Executing [teuton] (version 2.1.0)                    |
-| tt_scriptname | ...teuton.d/challenges/learn/learn-01-target/start.rb |
-| tt_configfile | ...ton.d/challenges/learn/learn-01-target/config.yaml |
-| tt_testname   | learn-01-target                                       |
-| tt_sequence   | false                                                 |
-+---------------+-------------------------------------------------------+
-
-CASE RESULTS
-+---------+-------+-------+-----------+
-| CASE ID | GRADE | STATE | MEMBERS   |
-| case_01 | 100.0 |       | anonymous |
-+---------+-------+-------+-----------+
-
-FINAL VALUES
-+-------------+---------------------------+
-| start_time  | 2019-10-04 23:44:19 +0100 |
-| finish_time | 2019-10-04 23:44:19 +0100 |
-| duration    | 0.006568696               |
-+-------------+---------------------------+
-```

data/docs/commands/show_version.md

@@ -1,9 +0,0 @@
-```bash
-$ teuton version                               
-teuton (version 2.0.0)
-```
-
-**Alias:**
-* `teuton v`
-* `teuton -v`
-* `teuton --version`

data/docs/developers/01-telnet.md

@@ -1,121 +0,0 @@
-
-# 01 - Conexión Telnet
-
-> ¡Vale, lo sé! No debería estar usando Telnet ni Windows 2012.
-> Pero ahora mismo es un reto personal y quiero descubrir qué está pasando.
-
----
-
-# Herramientas que uso
-
-He creado el siguiente [programa ruby](../../tests/manual/telnet.rb) para abrir
-una conexión telnet a una máquina remota, ejecutar un comando y mostrar
-el resutado en pantalla.
-
----
-
-# Gema net/Telnet
-
-Estoy usando la gema `net/telnet`, la cual en su [documentación](https://www.rubydoc.info/gems/net-telnet/0.2.0)
-pone lo siguiente:
-
-```
-# Usage
-# Log in and send a command, echoing all output to stdout
-
-localhost = Net::Telnet::new("Host" => "localhost",
-                             "Timeout" => 10,
-                             "Prompt" => /[$%#>] \z/n)
-localhost.login("username", "password") { |c| print c }
-localhost.cmd("command") { |c| print c }
-localhost.close
-```
-
-> Repositorio GitHub de la gema: https://github.com/ruby/net-telnet/
-
----
-
-# Comprobaciones
-
-## MV GNU/Linux Debian 9 con servidor telnet
-* Manualmente -> OK
-* Usando el programa -> OK
-
-```
-Testing : {:ip=>"192.168.1.106", :username=>"root", :password=>"profesor", :cmd=>"whoami"}
-Output  : ["whoami", "root", "root@vargas42d:~# "]
-
-Testing : {:ip=>"192.168.1.106", :username=>"profesor", :password=>"profesor", :cmd=>"whoami"}
-Output  : ["whoami", "profesor", "profesor@vargas42d:~$ "]
-```
-
-## MV Windows 2008 server con servidor Telnet
-* Manualmente -> OK
-* Usando el programa -> OK
-
-```
-Testing : {:ip=>"192.168.1.115", :username=>"Administrador", :password=>"profesorFP2018", :cmd=>"whoami"}
-Output  : ["whoami", "vargas42s08\\administrador", "", "C:\\Users\\Administrador>"]
-
-Testing : {:ip=>"192.168.1.115", :username=>"profesor", :password=>"sayonaraBABY2018", :cmd=>"whoami"}
-Output  : ["whoami", "vargas42s08\\profesor", "", "C:\\Users\\profesor>"]
-```
-
-## MV Windows 2012 server con servidor Telnet
-* Manualmente -> OK
-
-```
-david@camaleon:~/proy/tools/sysadmin-game> telnet 192.168.1.114
-Trying 192.168.1.114...
-Connected to 192.168.1.114.
-Escape character is '^]'.
-Welcome to Microsoft Telnet Service
-
-login: administrador
-password:
-
-*===============================================================
-Microsoft Telnet Server.
-*===============================================================
-C:\Users\Administrador>whoami
-vargas42s12\administrador
-
-C:\Users\Administrador>
-C:\Users\Administrador>exitConnection closed by foreign host.
-david@camaleon:~/proy/tools/sysadmin-game> telnet 192.168.1.114
-Trying 192.168.1.114...
-Connected to 192.168.1.114.
-Escape character is '^]'.
-Welcome to Microsoft Telnet Service
-
-login: profesor
-password:
-
-*===============================================================
-Microsoft Telnet Server.
-*===============================================================
-C:\>whoami
-vargas42s12\profesor
-
-C:\>exiConnection closed by foreign host.
-```
-* Usando el programa -> OK
-
-```
-david@camaleon:~/proy/tools/sysadmin-game> ./tests/manual/telnet.rb
-
-Testing : {:ip=>"192.168.1.114", :username=>"Administrador", :password=>"profesorFP2018", :cmd=>"whoami"}
-Output  : ["whoami", "vargas42s12\\administrador", "", "C:\\Users\\Administrador>"]
-
-Testing : {:ip=>"192.168.1.114", :username=>"profesor", :password=>"sayonaraBABY2018", :cmd=>"whoami"}
-Output  : ["whoami", "vargas42s12\\profesor", "", "C:\\Users\\profesor>"]
-
-```
----
-
-# Problema
-
-La aplicación falla cuando lo intento con Windows 2012 server.
-
-Creo que la estoy usando correctamente, pero hay algo que funciona diferente
-en Windows 2012 y no consigo identificar el qué.

data/docs/developers/02-ssh.md

@@ -1,93 +0,0 @@
-
-# 02 - Conexión SSH a PowerShell
-
----
-
-# Herramientas que uso
-
-He creado el programa de ruby [ssh.rb](../../tests/manual/ssh.rb) para abrir
-una conexión SSH a una máquina remota, ejecutar un comando y mostrar
-el resutado en pantalla.
-
----
-
-# Gema net/ssh
-
-Estoy usando la gema `net/ssh`, la cual en su [documentación](hhttp://net-ssh.github.io/net-ssh/)
-pone lo siguiente:
-
-```
-require 'net/ssh'
-
-Net::SSH.start('host', 'user', password: "password") do |ssh|
-  # capture all stderr and stdout output from a remote process
-  output = ssh.exec!("hostname")
-  puts output
-end
-```
-
-> Repositorio GitHub de la gema: https://github.com/net-ssh/net-ssh
-
----
-
-# Comprobaciones
-
-## Debian 9 con servidor SSH
-
-Todos los comandos que se ejecutan vía SSH por esta herramienta funcionan correctamente.
-
-## MV Windows 2012 server con servidor SSH
-
-* Manualmente -> OK (usando ssh con sshpass)
-
-```
-david@camaleon:~/proy/tools/sysadmin-game> sshpass -p profesorFP2018 ssh administrador@192.168.1.114 'get-windowsfeature -name rds-rd-server'
-
-Display Name                                            Name                   
-------------                                            ----                   
-    [ ] Host de sesi�n de Escritorio remoto             RDS-RD-Server          
-
-```
-
-* Manualmente -> OK (usando ssh)
-
-```
-david@camaleon:~/proy/tools/sysadmin-game> ssh administrador@192.168.1.114 'get-windowsfeature -name rds-rd-server'
-administrador@192.168.1.114's password:
-
-Display Name                                            Name                   
-------------                                            ----                   
-    [ ] Host de sesi�n de Escritorio remoto             RDS-RD-Server          
-```
-
-* Usando el programa -> OK (Comando whoami)
-
-```
-david@camaleon:~/proy/tools/sysadmin-game> ./tests/manual/ssh.rb
-
-Testing : {:ip=>"192.168.1.114", :username=>"Administrador", :password=>"profesorFP2018", :cmd=>"whoami"}
-Output  : ["vargas42s12\\administrador\r"]
-
-```
-
-* Usando el programa -> ERROR!!!! (Comando get-windowsfeature) La salida está vacía.
-
-```
-david@camaleon:~/proy/tools/sysadmin-game> ./tests/manual/ssh.rb
-
-Testing : {:ip=>"192.168.1.114", :username=>"Administrador", :password=>"profesorFP2018", :cmd=>"get-windowsfeature -name rds-rd-server"}
-[ArgumentError] SSH on <Administrador@192.168.1.114> exec: get-windowsfeature -name rds-rd-server
-Output  : []
-
-```
-
----
-
-# Problema
-
-La librería `net/ssh` parece que no recoge el resultado cuando se ejecuta el comando de PowerShell `get-windowsfeature -name rds-server` en Windows 2012 server.
-
-Pero si lo hago de forma manual SI funciona.
-
-¿Puede ser que algunos comandos de PowerShell no se comportan como lo hacen todos los comandos y generan
-una salida que no puede capturar bien la librería?