Manual de referencia de GNU Guix: Uso del gestor de paquetes funcional GNU Guix.

590 Pages·2021·2.034 MB·Spanish

by  Las desarrolladoras de GNU Guix

Manual de referencia de GNU Guix
Uso del gestor de paquetes funcional GNU Guix.
Las desarrolladoras de GNU Guix
Edici´on 1.3.0
20 May 2021
Copyright (cid:13)c 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021 Ludovic Court`es
Copyright (cid:13)c 2013, 2014, 2016 Andreas Enge
Copyright (cid:13)c 2013 Nikita Karetnikov
Copyright (cid:13)c 2014, 2015, 2016 Alex Kost
Copyright (cid:13)c 2015, 2016 Mathieu Lirzin
Copyright (cid:13)c 2014 Pierre-Antoine Rault
Copyright (cid:13)c 2015 Taylan Ulrich Bayırlı/Kammer
Copyright (cid:13)c 2015, 2016, 2017, 2019, 2020, 2021 Leo Famulari
Copyright (cid:13)c 2015, 2016, 2017, 2018, 2019, 2020 Ricardo Wurmus
Copyright (cid:13)c 2016 Ben Woodcroft
Copyright (cid:13)c 2016, 2017, 2018, 2021 Chris Marusich
Copyright (cid:13)c 2016, 2017, 2018, 2019, 2020, 2021 Efraim Flashner
Copyright (cid:13)c 2016 John Darrington
Copyright (cid:13)c 2016, 2017 Nikita Gillmann
Copyright (cid:13)c 2016, 2017, 2018, 2019, 2020 Jan Nieuwenhuizen
Copyright (cid:13)c 2016, 2017, 2018, 2019, 2020 Julien Lepiller
Copyright (cid:13)c 2016 Alex ter Weele
Copyright (cid:13)c 2016, 2017, 2018, 2019, 2020, 2021 Christopher Baines
Copyright (cid:13)c 2017, 2018, 2019 Cl´ement Lassieur
Copyright (cid:13)c 2017, 2018, 2020, 2021 Mathieu Othacehe
Copyright (cid:13)c 2017 Federico Beffa
Copyright (cid:13)c 2017, 2018 Carlo Zancanaro
Copyright (cid:13)c 2017 Thomas Danckaert
Copyright (cid:13)c 2017 humanitiesNerd
Copyright (cid:13)c 2017, 2021 Christopher Lemmer Webber
Copyright (cid:13)c 2017, 2018, 2019, 2020 Marius Bakke
Copyright (cid:13)c 2017, 2019, 2020 Hartmut Goebel
Copyright (cid:13)c 2017, 2019, 2020, 2021 Maxim Cournoyer
Copyright (cid:13)c 2017, 2018, 2019, 2020, 2021 Tobias Geerinckx-Rice
Copyright (cid:13)c 2017 George Clemmer
Copyright (cid:13)c 2017 Andy Wingo
Copyright (cid:13)c 2017, 2018, 2019, 2020 Arun Isaac
Copyright (cid:13)c 2017 nee
Copyright (cid:13)c 2018 Rutger Helling
Copyright (cid:13)c 2018, 2021 Oleg Pykhalov
Copyright (cid:13)c 2018 Mike Gerwitz
Copyright (cid:13)c 2018 Pierre-Antoine Rouby
Copyright (cid:13)c 2018, 2019 G´abor Boskovits
Copyright (cid:13)c 2018, 2019, 2020 Florian Pelz
Copyright (cid:13)c 2018 Laura Lazzati
Copyright (cid:13)c 2018 Alex Vong
Copyright (cid:13)c 2019 Josh Holland
Copyright (cid:13)c 2019, 2020 Diego Nicola Barbato
Copyright (cid:13)c 2019 Ivan Petkov
Copyright (cid:13)c 2019 Jakob L. Kreuze
Copyright (cid:13)c 2019 Kyle Andrews
Copyright (cid:13)c 2019 Alex Griffin
Copyright (cid:13)c 2019, 2020 Guillaume Le Vaillant
Copyright (cid:13)c 2020 Leo Prikler
Copyright (cid:13)c 2019, 2020 Simon Tournier
Copyright (cid:13)c 2020 Wiktor Z˙elazny
Copyright (cid:13)c 2020 Damien Cassou
Copyright (cid:13)c 2020 Jakub Kądziol(cid:32)ka
Copyright (cid:13)c 2020 Jack Hill
Copyright (cid:13)c 2020 Naga Malleswari
Copyright (cid:13)c 2020 Brice Waegeneire
Copyright (cid:13)c 2020 R Veera Kumar
Copyright (cid:13)c 2020 Pierre Langlois
Copyright (cid:13)c 2020 pinoaffe
Copyright (cid:13)c 2020 Andr´e Batista
Copyright (cid:13)c 2020, 2021 Alexandru-Sergiu Marton
Copyright (cid:13)c 2020 raingloom
Copyright (cid:13)c 2020 Daniel Brooks
Copyright (cid:13)c 2020 John Soo
Copyright (cid:13)c 2020 Jonathan Brielmaier
Copyright (cid:13)c 2020 Edgar Vincent
Copyright (cid:13)c 2021 Maxime Devos
Se garantiza el permiso de copia, distribuci´on y/o modificaci´on de este documento bajo los
t´erminosdelalicenciadedocumentaci´onlibredeGNU(GNUFreeDocumentationLicense),
versi´on 1.3 o cualquier versi´on posterior publicada por la Free Software Foundation; sin
secciones invariantes, sin textos de cubierta delantera ni trasera. Una copia de la licencia
est´a incluida en la secci´on titulada “GNU Free Documentation License”.
i
´
Indice General
GNU Guix........................................... 1
1 Introduccio´n ..................................... 2
1.1 Gesti´on de software con Guix................................... 2
1.2 Distribuci´on GNU.............................................. 3
2 Instalacio´n ....................................... 5
2.1 Instalaci´on binaria.............................................. 5
2.2 Requisitos...................................................... 8
2.3 Ejecuci´on de la bater´ıa de pruebas.............................. 9
2.4 Preparaci´on del daemon....................................... 10
2.4.1 Configuraci´on del entorno de construcci´on.................10
2.4.2 Uso de la facilidad de delegaci´on de trabajo............... 12
2.4.3 Soporte de SELinux ...................................... 15
2.4.3.1 Instalaci´on de la pol´ıtica de SELinux................. 15
2.4.3.2 Limitaciones......................................... 16
2.5 Invocaci´on de guix-daemon.................................... 16
2.6 Configuraci´on de la aplicaci´on................................. 21
2.6.1 Localizaciones............................................ 21
2.6.2 Selector de servicios de nombres .......................... 22
2.6.3 Tipograf´ıas X11.......................................... 22
2.6.4 Certificados X.509........................................ 23
2.6.5 Paquetes Emacs.......................................... 23
2.7 Actualizar Guix............................................... 24
3 Instalacio´n del sistema......................... 25
3.1 Limitaciones...................................................25
3.2 Consideraciones sobre el hardware............................. 25
3.3 Instalaci´on desde memoria USB y DVD........................ 26
Copiado en una memoria USB................................... 26
Grabaci´on en un DVD........................................... 26
Arranque........................................................ 26
3.4 Preparaci´on para la instalaci´on................................ 27
3.5 Instalaci´on gr´afica guiada...................................... 27
3.6 Instalaci´on manual............................................ 30
3.6.1 Distribuci´on de teclado, red y particionado................ 30
3.6.1.1 Distribuci´on de teclado .............................. 31
3.6.1.2 Red ................................................. 31
3.6.1.3 Particionado de discos............................... 32
3.6.2 Procedimiento de instalaci´on.............................. 34
3.7 Tras la instalaci´on del sistema................................. 35
3.8 Instalaci´on de Guix en una m´aquina virtual.................... 35
ii
3.9 Construcci´on de la imagen de instalaci´on.......................36
3.10 Construcci´on de la imagen de instalaci´on para placas ARM ... 36
4 Empezando ..................................... 37
5 Gestio´n de paquetes ........................... 40
5.1 Caracter´ısticas ................................................ 40
5.2 Invocaci´on de guix package................................... 41
5.3 Sustituciones.................................................. 51
5.3.1 Servidor oficial de sustituciones............................51
5.3.2 Autorizaci´on de servidores de sustituciones................ 52
5.3.3 Obtenci´on de sustiticiones desde otros servidores.......... 53
5.3.4 Verificaci´on de sustituciones .............................. 54
5.3.5 Configuraci´on de la pasarela...............................55
5.3.6 Fallos en las sustituciones................................. 55
5.3.7 Sobre la confianza en binarios............................. 55
5.4 Paquetes con mu´ltiples salidas................................. 56
5.5 Invocaci´on de guix gc......................................... 56
5.6 Invocaci´on de guix pull.......................................60
5.7 Invocaci´on de guix time-machine............................. 63
5.8 Inferiores...................................................... 64
5.9 Invocaci´on de guix describe.................................. 66
5.10 Invocaci´on de guix archive.................................. 68
6 Canales ......................................... 71
6.1 Especificaci´on de canales adicionales........................... 71
6.2 Uso de un canal de Guix personalizado ........................ 72
6.3 Replicaci´on de Guix........................................... 72
6.4 Verificaci´on de canales......................................... 73
6.5 Channels with Substitutes..................................... 73
6.6 Creaci´on de un canal.......................................... 74
6.7 M´odulos de paquetes en un subdirectorio ...................... 75
6.8 Declaraci´on de dependencias de canales........................ 75
6.9 Especificaci´on de autorizaciones del canal...................... 75
6.10 URL primaria................................................ 77
6.11 Escribir de noticias del canal ................................. 77
7 Desarrollo....................................... 79
7.1 Invocaci´on de guix environment.............................. 79
7.2 Invocaci´on de guix pack.......................................84
7.3 La cadena de herramientas de GCC............................ 89
7.4 Invocaci´on de guix git authenticate......................... 90
iii
8 Interfaz program´atica.......................... 91
8.1 M´odulos de paquetes.......................................... 91
8.2 Definici´on de paquetes......................................... 92
8.2.1 Referencia de package.................................... 95
8.2.2 Referencia de origin..................................... 98
8.3 Definici´on de variantes de paquetes........................... 101
8.4 Sistemas de construcci´on..................................... 104
8.5 Fases de construcci´on.........................................121
8.6 Utilidades de construcci´on.................................... 124
8.6.1 Tratamiento de nombres de archivo del almac´en.......... 125
8.6.2 Tipos de archivo.........................................125
8.6.3 Manipulaci´on de archivos................................ 126
8.6.4 Bu´squeda de archivos.................................... 127
8.6.5 Fases de construcci´on.................................... 128
8.7 El almac´en................................................... 129
8.8 Derivaciones..................................................131
8.9 La m´onada del almac´en ...................................... 134
8.10 Expresiones-G...............................................139
8.11 Invocaci´on de guix repl.................................... 148
9 Utilidades ..................................... 150
9.1 Invocaci´on de guix build.................................... 150
9.1.1 Opciones comunes de construcci´on....................... 150
9.1.2 Opciones de transformaci´on de paquetes................. 153
9.1.3 Opciones de construcci´on adicionales.....................157
9.1.4 Depuraci´on de fallos de construcci´on..................... 162
9.2 Invocaci´on de guix edit ..................................... 163
9.3 Invocaci´on de guix download................................. 163
9.4 Invocaci´on de guix hash ..................................... 164
9.5 Invocaci´on de guix import................................... 165
9.6 Invocaci´on de guix refresh.................................. 171
9.7 Invocaci´on de guix lint ..................................... 176
9.8 Invocaci´on de guix size ..................................... 179
9.9 Invocaci´on de guix graph.................................... 181
9.10 Invocaci´on de guix publish................................. 186
9.11 Invocaci´on de guix challenge .............................. 190
9.12 Invocaci´on de guix copy.................................... 193
9.13 Invocaci´on de guix container .............................. 194
9.14 Invocaci´on de guix weather................................. 194
9.15 Invocaci´on de guix processes .............................. 196
10 Configuracio´n del sistema................... 199
10.1 Uso de la configuraci´on del sistema.......................... 199
Cargador de arranque.......................................... 200
Paquetes visibles globalmente...................................201
Servicios del sistema............................................201
Instanciaci´on del sistema....................................... 206
iv
La interfaz program´atica ....................................... 206
10.2 Referencia de operating-system............................ 206
10.3 Sistemas de archivos ........................................ 211
10.3.1 Sistema de archivos Btrfs............................... 215
10.4 Dispositivos traducidos...................................... 216
10.5 Cuentas de usuaria.......................................... 218
10.6 Distribuci´on de teclado...................................... 221
10.7 Localizaciones............................................... 223
10.7.1 Consideraciones sobre la
compatibilidad de datos de localizaci´on....................... 224
10.8 Servicios.................................................... 225
10.8.1 Servicios base.......................................... 226
10.8.2 Ejecuci´on de tareas programadas....................... 240
10.8.3 Rotaci´on del registro de mensajes....................... 242
10.8.4 Servicios de red ........................................ 244
10.8.5 Actualizaciones no-atendidas ........................... 269
10.8.6 Sistema X Window..................................... 272
10.8.7 Servicios de impresi´on.................................. 278
10.8.8 Servicios de escritorio...................................291
10.8.9 Servicios de sonido..................................... 300
10.8.10 Servicios de bases de datos............................ 302
10.8.11 Servicios de correo .................................... 307
10.8.12 Servicios de mensajer´ıa................................ 335
10.8.13 Servicios de telefon´ıa.................................. 343
10.8.14 File-Sharing Services.................................. 346
10.8.15 Servicios de monitorizaci´on............................ 357
10.8.16 Servicios Kerberos.....................................364
10.8.17 Servicios LDAP....................................... 366
10.8.18 Servicios Web......................................... 372
10.8.19 Servicios de certificados ............................... 392
10.8.20 Servicios DNS......................................... 395
10.8.21 Servicios VPN.........................................408
10.8.22 Sistema de archivos en red.............................414
10.8.23 Integraci´on continua...................................417
10.8.24 Servicios de gesti´on de energ´ıa......................... 421
10.8.25 Servicios de audio..................................... 429
10.8.26 Servicios de virtualizaci´on............................. 430
10.8.27 Servicios de control de versiones....................... 454
10.8.28 Servicios de juegos.................................... 471
10.8.29 Servicio PAM Mount.................................. 471
10.8.30 Servicios de Guix......................................473
10.8.31 Servicios de Linux..................................... 477
10.8.32 Servicios de Hurd..................................... 480
10.8.33 Servicios miscel´aneos.................................. 480
10.9 Programas con setuid ....................................... 487
10.10 Certificados X.509 ......................................... 488
10.11 Selector de servicios de nombres............................ 489
10.12 Disco en RAM inicial ...................................... 491
v
10.13 Configuraci´on del gestor de arranque....................... 494
10.14 Invocaci´on de guix system................................. 499
10.15 Invocaci´on de guix deploy................................. 507
10.16 Ejecuci´on de Guix en una m´aquina virtual..................511
10.16.1 Conexi´on a trav´es de SSH............................. 512
10.16.2 Uso de virt-viewer con Spice........................ 513
10.17 Definici´on de servicios...................................... 513
10.17.1 Composici´on de servicios.............................. 513
10.17.2 Tipos de servicios y servicios.......................... 515
10.17.3 Referencia de servicios.................................517
10.17.4 Servicios de Shepherd................................. 521
11 Documentacio´n .............................. 526
12 Instalacio´n de archivos de depuracio´n ..... 527
12.1 Informaci´on separada para depuraci´on....................... 527
12.2 Reconstrucci´on de la informaci´on para depuraci´on........... 528
13 Actualizaciones de seguridad ............... 530
14 Lanzamiento inicial.......................... 532
14.1 El lanzamiento inicial a partir de la semilla binaria reducida.. 532
14.2 Preparaci´on para usar los binarios del lanzamiento inicial.... 535
Construcci´on de las herramientas de construcci´on.................. 536
Construir los binarios de lanzamiento.............................. 538
Reducci´on del conjunto de binarios de lanzamiento................. 538
15 Transportar a una nueva plataforma....... 540
16 Contribuir.................................... 541
16.1 Construcci´on desde Git......................................541
16.2 Ejecuci´on de Guix antes de estar instalado...................543
16.3 La configuraci´on perfecta.................................... 544
16.4 Pautas de empaquetamiento................................. 545
16.4.1 Libertad del software................................... 546
16.4.2 Nombrado de paquetes................................. 546
16.4.3 Versiones num´ericas.................................... 547
16.4.4 Sinopsis y descripciones ................................ 548
16.4.5 snippets frente a fases................................. 549
16.4.6 Paquetes Emacs........................................ 549
16.4.7 M´odulos Python........................................550
16.4.7.1 Especificaci´on de dependencias.....................550
16.4.8 M´odulos Perl........................................... 551
16.4.9 Paquetes Java.......................................... 551
16.4.10 Crates de Rust........................................ 552
16.4.11 Tipograf´ıas............................................552
vi
16.5 Estilo de codificaci´on........................................ 553
16.5.1 Paradigma de programaci´on............................ 553
16.5.2 M´odulos................................................553
16.5.3 Tipos de datos y reconocimiento de patrones............ 553
16.5.4 Formato del c´odigo..................................... 553
16.6 Env´ıo de parches............................................ 554
Env´ıo de una serie de parches...................................557
16.7 Seguimiento de errores y parches............................ 557
16.8 Acceso al repositorio........................................ 558
16.9 Actualizar el paquete Guix.................................. 560
17 Reconocimientos............................. 561
Ap´endice A Licencia de
documentaci´on libre GNU.....................562
´
Indice de conceptos............................... 570
´
Indice program´atico .............................. 578
1
GNU Guix
Este documento describe GNU Guix versi´on 1.3.0, una herramienta funcional de gesti´on de
paquetes escrita para el sistema GNU.
This manual is also available in Simplified Chinese (v´ease GNU Guix), French (v´ease
Manuel de r´ef´erence de GNU Guix), German (v´ease Referenzhandbuch zu GNU Guix),
Spanish (v´ease Manual de referencia de GNU Guix), and Russian (v´ease GNU Guix). If
you would like to translate it in your native language, consider joining Weblate (https://
translate.fedoraproject.org/projects/guix/documentation-manual).