.\" -*- coding: UTF-8 -*-
'\" t
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de  UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ARCHINSTALL 1 "Nov 23, 2024" "" python\-archinstall
.SH NOME
archinstall \- Documentação do archinstall
.sp
\fBarchinstall\fP is library which can be used to install Arch Linux.  The
library comes packaged with different pre\-configured installers, such as the
default \fI\%Guided installation\fP installer.
.sp
A demo of the \fI\%Guided installation\fP installer can be seen here: \X'tty: link https://www.youtube.com/watch?v=9Xt7X_Iqg6E'\fI\%https://www.youtube.com/watch?v=9Xt7X_Iqg6E\fP\X'tty: link'\&.
.sp
Alguns dos recursos do Archinstall são:
.INDENT 0.0
.IP \(bu 2
\fBSeparação em contextos.\fP A biblioteca sempre executa chamadas em ordem
sequencial para garantir que as etapas de instalação não se sobreponham ou
sejam executadas na ordem errada. Ela também oferece suporte a \fI(e usa)\fP
envoltórios de contexto para garantir que tarefas de limpeza e final, como
\fBmkinitcpio\fP, sejam chamadas quando necessário.
.IP \(bu 2
\fBTransparência total\fP Logs e insights podem ser encontrados em
\fB/var/log/archinstall\fP tanto no ISO ativo quanto parcialmente no sistema
instalado.
.IP \(bu 2
\fBAcessível\fP O Archinstall funciona com \fBespeakup\fP e outras ferramentas de
acessibilidade graças ao uso de um TUI.
.UNINDENT
.SH "INSTALAÇÃO GUIADA"
.sp
O Archinstall vem com um \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py'\fI\%Instalador Guiado\fP\X'tty: link' pré\-programado que guia você pelas etapas obrigatórias,
bem como algumas configurações opcionais que podem ser feitas.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Outros scripts pré\-programados podem ser invocados executando \fBarchinstall <script>\fP \fI(sem .py)\fP\&. Para ver uma lista completa de scripts,
execute \fBarchinstall \-\-script list\fP ou verifique o diretório \X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link' do código\-fonte.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
É recomendável executar o \fBarchinstall\fP a partir do ISO oficial do Arch
Linux.
.UNINDENT
.UNINDENT
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
O instalador não configurará o WiFi antes do início da instalação. Você
precisa ler sobre \X'tty: link https://wiki.archlinux.org/index.php/Network_configuration'\fI\%conectividade no Arch Linux\fP\X'tty: link' antes de continuar.
.UNINDENT
.UNINDENT
.SS "Executando a instalação guiada"
.sp
Para iniciar o instalador, execute o seguinte no ISO mais recente do Arch
Linux:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Como o \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py'\fI\%Instalador Guiado\fP\X'tty: link' é o script padrão, isso é o equivalente a executar
\fBarchinstall guided\fP
.sp
A instalação guiada também oferece suporte a instalação com respostas
pré\-configuradas para todas as etapas guiadas. Esta pode ser uma maneira
rápida e conveniente de executar novamente uma ou várias instalações.
.sp
Há dois arquivos de configuração, ambos opcionais.
.SS \-\-config
.sp
Este parâmetro recebe um arquivo \fB\&.json\fP local ou remoto como argumento e
contém a configuração geral e as respostas do menu para o instalador guiado.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Você sempre pode obter as opções mais recentes para este arquivo com
\fBarchinstall \-\-dry\-run\fP, que executa o instalador guiado em um modo seguro,
onde nenhuma ação permanente será tomada no seu sistema, mas simula uma
execução e salva a configuração no disco.
.UNINDENT
.UNINDENT
.SS "Exemplo de uso"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall \-\-config https://domain.lan/config.json
.EE
.UNINDENT
.UNINDENT
.sp
O conteúdo de \fBhttps://domain.lan/config.json\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    "__separator__": null,
    "additional\-repositories": [],
    "archinstall\-language": "English",
    "audio_config": null,
    "bootloader": "Systemd\-boot",
    "config_version": "2.6.0",
    "debug": false,
    "disk_config": {
        "config_type": "manual_partitioning",
        "device_modifications": [
            {
                "device": "/dev/sda",
                "partitions": [
                    {
                        "btrfs": [],
                        "flags": [
                            "boot"
                        ],
                        "fs_type": "fat32",
                        "length": {
                            "sector_size": null,
                            "total_size": null,
                            "unit": "B",
                            "value": 99982592
                        },
                        "mount_options": [],
                        "mountpoint": "/boot",
                        "obj_id": "369f31a8\-2781\-4d6b\-96e7\-75680552b7c9",
                        "start": {
                            "sector_size": {
                                "sector_size": null,
                                "total_size": null,
                                "unit": "B",
                                "value": 512
                            },
                            "total_size": null,
                            "unit": "sectors",
                            "value": 34
                        },
                        "status": "create",
                        "type": "primary"
                    },
                    {
                        "btrfs": [],
                        "flags": [],
                        "fs_type": "fat32",
                        "length": {
                            "sector_size": null,
                            "total_size": null,
                            "unit": "B",
                            "value": 100000000
                        },
                        "mount_options": [],
                        "mountpoint": "/efi",
                        "obj_id": "13cf2c96\-8b0f\-4ade\-abaa\-c530be589aad",
                        "start": {
                            "sector_size": {
                                "sector_size": null,
                                "total_size": null,
                                "unit": "B",
                                "value": 512
                            },
                            "total_size": {
                                "sector_size": null,
                                "total_size": null,
                                "unit": "B",
                                "value": 16106127360
                            },
                            "unit": "MB",
                            "value": 100
                        },
                        "status": "create",
                        "type": "primary"
                    },
                    {
                        "btrfs": [],
                        "flags": [],
                        "fs_type": "ext4",
                        "length": {
                            "sector_size": null,
                            "total_size": null,
                            "unit": "B",
                            "value": 15805127360
                        },
                        "mount_options": [],
                        "mountpoint": "/",
                        "obj_id": "3e75d045\-21a4\-429d\-897e\-8ec19a006e8b",
                        "start": {
                            "sector_size": {
                                "sector_size": null,
                                "total_size": null,
                                "unit": "B",
                                "value": 512
                            },
                            "total_size": {
                                "sector_size": null,
                                "total_size": null,
                                "unit": "B",
                                "value": 16106127360
                            },
                            "unit": "MB",
                            "value": 301
                        },
                        "status": "create",
                        "type": "primary"
                    }
                ],
                "wipe": false
            }
        ]
    },
    "disk_encryption": {
        "encryption_type": "luks",
        "partitions": [
            "3e75d045\-21a4\-429d\-897e\-8ec19a006e8b"
        ]
    },
    "hostname": "archlinux",
    "kernels": [
        "linux"
    ],
    "locale_config": {
        "kb_layout": "us",
        "sys_enc": "UTF\-8",
        "sys_lang": "en_US"
    },
    "mirror_config": {
        "custom_mirrors": [],
        "mirror_regions": {
            "Sweden": [
                "https://mirror.osbeck.com/archlinux/$repo/os/$arch",
                "https://mirror.bahnhof.net/pub/archlinux/$repo/os/$arch",
                "https://ftp.myrveln.se/pub/linux/archlinux/$repo/os/$arch",
                "https://ftp.lysator.liu.se/pub/archlinux/$repo/os/$arch",
                "https://ftp.ludd.ltu.se/mirrors/archlinux/$repo/os/$arch",
                "https://ftp.acc.umu.se/mirror/archlinux/$repo/os/$arch",
                "http://mirror.bahnhof.net/pub/archlinux/$repo/os/$arch",
                "http://ftpmirror.infania.net/mirror/archlinux/$repo/os/$arch",
                "http://ftp.myrveln.se/pub/linux/archlinux/$repo/os/$arch",
                "http://ftp.lysator.liu.se/pub/archlinux/$repo/os/$arch",
                "http://ftp.acc.umu.se/mirror/archlinux/$repo/os/$arch"
            ]
        }
    },
    "network_config": {},
    "no_pkg_lookups": false,
    "ntp": true,
    "offline": false,
    "packages": [],
    "parallel downloads": 0,
    "profile_config": null,
    "save_config": null,
    "script": "guided",
    "silent": false,
    "swap": true,
    "timezone": "UTC",
    "version": "2.6.0"
}
.EE
.UNINDENT
.UNINDENT
.SS "Opções de \-\-config"
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Todas as entradas de chave e valor devem estar em conformidade com o padrão
JSON. Abaixo estão exemplos legíveis por humanos com links, quebrando
efetivamente a sintaxe. Adapte as descrições abaixo para atender às suas
necessidades e ao formato JSON.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Role para a direita na tabela para ver as opções necessárias.
.UNINDENT
.UNINDENT
.SS "Opções JSON"
.TS
box center;
l|l|l|l.
T{
Chave
T}	T{
Valor(es)
T}	T{
Descrição
T}	T{
Obrigatório
T}
_
T{
additional\-repositories
T}	T{
[ \X'tty: link https://wiki.archlinux.org/title/Official_repositories#multilib'\fI\%multilib\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Official_repositories#Testing_repositories'\fI\%testing\fP\X'tty: link' ]
T}	T{
Habilita um ou mais repositórios de teste e multilib antes de prosseguir com a instalação
T}	T{
Não
T}
_
T{
archinstall\-language
T}	T{
\X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/locales/languages.json'\fI\%lang\fP\X'tty: link'
T}	T{
Define o idioma da interface de usuário de base texto (TUI) usado \fI(certifique\-se de usar o valor \(ga\(galang\(ga\(ga, e não \(ga\(gaabbr\(ga\(ga)\fP
T}	T{
Não
T}
_
T{
audio_config
T}	T{
\X'tty: link https://wiki.archlinux.org/title/PipeWire'\fI\%pipewire\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/PulseAudio'\fI\%pulseaudio\fP\X'tty: link'
T}	T{
Servidor de áudio a ser instalado
T}	T{
Não
T}
_
T{
bootloader
T}	T{
\X'tty: link https://wiki.archlinux.org/title/Systemd\-boot'\fI\%Systemd\-boot\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/GRUB'\fI\%grub\fP\X'tty: link'
T}	T{
Gerenciador de inicialização a ser instalado \fI(grub sendo obrigatório em máquinas BIOS)\fP
T}	T{
Sim
T}
_
T{
debug
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita saída de depuração
T}	T{
Não
T}
_
T{
disk_config
T}	T{
\fILeia mais em\fP \fI\%Configuração de disco\fP
T}	T{
Contém a configuração de disco desejada a ser usada durante a instalação
T}	T{
Não
T}
_
T{
disk_encryption
T}	T{
\fILeia mais em\fP \fI\%Criptografia de disco\fP
T}	T{
Parâmetros para criptografia de disco aplicados sobre \fBdisk_config\fP
T}	T{
Não
T}
_
T{
hostname
T}	T{
\fBstr\fP
T}	T{
Uma string que define o nome de máquina da sua máquina na rede \fI(o padrão é \(ga\(gaarchinstall\(ga\(ga)\fP
T}	T{
Não
T}
_
T{
kernels
T}	T{
[ \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-hardened\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-lts\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-rt\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-rt\-lts\fP\X'tty: link', \X'tty: link https://wiki.archlinux.org/title/Kernel#Officially_supported_kernels'\fI\%linux\-zen\fP\X'tty: link' ]
T}	T{
Define quais kernels devem ser instalados e configurados nas opções do gerenciador de inicialização
T}	T{
Sim
T}
_
T{
custom\-commands
T}	T{
\fILeia mais em\fP \fI\%Comandos personalizados\fP
T}	T{
Comandos personalizados que serão executados após a instalação com chroot dentro do sistema instalado
T}	T{
Não
T}
_
T{
locale_config
T}	T{
{kb_layout: \X'tty: link https://wiki.archlinux.org/title/Linux_console/Keyboard_configuration'\fI\%lang\fP\X'tty: link', sys_enc: \X'tty: link https://wiki.archlinux.org/title/Locale'\fI\%Character encoding\fP\X'tty: link', sys_lang: \X'tty: link https://wiki.archlinux.org/title/Locale'\fI\%locale\fP\X'tty: link'}
T}	T{
Define o mapa de teclas do teclado, a codificação do sistema e a localidade do sistema
T}	T{
Não
T}
_
T{
mirror_config
T}	T{
{custom_mirrors: [ \X'tty: link https://'\fI\%https://\fP\X'tty: link'\&... ], mirror_regions: { "Worldwide": [ "\X'tty: link https://geo.mirror.pkgbuild.com/$repo/os/$arch'\fI\%https://geo.mirror.pkgbuild.com/$repo/os/$arch\fP\X'tty: link'" ] } }
T}	T{
Define vários espelhos \fI(o padrão é o \(ga\(ga/etc/pacman.d/mirrors\(ga\(ga da ISO, se não definido)\fP
T}	T{
Não
T}
_
T{
network_config
T}	T{
\fI\(gaveja as opções em Configuração de rede\(ga\fP
T}	T{
Define qual tipo de configuração de rede \fI(se houver)\fP deve ser usado
T}	T{
Não
T}
_
T{
no_pkg_lookups
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Desabilita verificação de pacotes em \X'tty: link https://archlinux.org/packages/'\fI\%https://archlinux.org/packages/\fP\X'tty: link'
T}	T{
Não
T}
_
T{
ntp
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita ou desabilita \X'tty: link https://wiki.archlinux.org/title/Network_Time_Protocol_daemon'\fI\%NTP\fP\X'tty: link' durante a instalação
T}	T{
Não
T}
_
T{
offline
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita ou desabilita certas verificações online tal como alcance de espelhos etc.
T}	T{
Não
T}
_
T{
packages
T}	T{
[ <pacote1>, <pacote2>, ... ]
T}	T{
Uma lista de pacotes para instalar durante a instalação
T}	T{
Não
T}
_
T{
parallel downloads
T}	T{
0\-∞
T}	T{
Define um determinado número de downloads paralelos a serem usados ​​pelo \X'tty: link https://wiki.archlinux.org/title/Pacman#Enabling_parallel_downloads'\fI\%pacman\fP\X'tty: link'
T}	T{
Não
T}
_
T{
profile_config
T}	T{
\fI\(galeia mais na seção de perfis\(ga\fP
T}	T{
Instala um perfil dado se definido
T}	T{
Não
T}
_
T{
script
T}	T{
\X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py'\fI\%guided\fP\X'tty: link' \fI(padrão)\fP, \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/minimal.py'\fI\%minimal\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/only_hdd.py'\fI\%only_hdd\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/swiss.py'\fI\%swiss\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/unattended.py'\fI\%unattended\fP\X'tty: link'
T}	T{
Quando usado para executar automaticamente uma instalação, isso define qual script executar automaticamente
T}	T{
Não
T}
_
T{
silent
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Desabilita ou habilita perguntas do usuário usando o TUI
T}	T{
Não
T}
_
T{
swap
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
Habilita ou desabilita swap
T}	T{
Não
T}
_
T{
timezone
T}	T{
\X'tty: link https://wiki.archlinux.org/title/System_time#Time_zone'\fI\%timezone\fP\X'tty: link'
T}	T{
Define um fuso horário para o sistema instalado
T}	T{
Não
T}
.TE
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Se nenhuma entrada for encontrada em \fBdisk_config\fP, a instalação guiada do
archinstall usará o que estiver montado atualmente em \fB/mnt/archinstall\fP
sem executar nenhuma operação de disco.
.UNINDENT
.UNINDENT
.SS "Opções para \-\-creds"
.sp
Creds is a separate configuration file to separate normal options from more
sensitive data like passwords.  Below is an example of how to set the root
password and below that are description of other values that can be set.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    "!root\-password" : "PapaiNoel2022"
}
.EE
.UNINDENT
.UNINDENT
.SS "Opções de \-\-creds"
.TS
box center;
l|l|l|l.
T{
Chave
T}	T{
Valores
T}	T{
Descrição
T}	T{
Obrigatório
T}
_
T{
!encryption\-password
T}	T{
\fBstr\fP
T}	T{
Senha para criptografar o disco, não criptografada se a senha não for fornecida
T}	T{
Não
T}
_
T{
!root\-password
T}	T{
\fBstr\fP
T}	T{
A senha da conta root
T}	T{
Não
T}
_
T{
!users
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    "username": "<USUÁRIO>",
    "!password": "<SENHA>",
    "sudo": false
}
.EE
.UNINDENT
.UNINDENT
T}	T{
Lista de credenciais de usuários regulares, veja a configuração para referência
T}	T{
Talvez
T}
.TE
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
\fB!users\fP é opcional somente se \fB!root\-password\fP foi definido. \fB!users\fP
será imposto caso contrário e a quantidade mínima de usuários com
privilégios sudo necessária será definida como 1.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
As chaves começam com \fB!\fP porque as funções de log internas mascararão
quaisquer chaves que comecem com explicações de logs e configurações
irrestritas.
.UNINDENT
.UNINDENT
.SH "PROBLEMAS CONHECIDOS"
.sp
Some issues are out of the \X'tty: link https://github.com/archlinux/archinstall/'\fI\%archinstall\fP\X'tty: link'
projects scope, and the ones we know of are listed below.
.SS "Espera pela sincronização de tempo \X'tty: link https://github.com/archlinux/archinstall/issues/2144'\fI\%#2144\fP\X'tty: link'"
.sp
The usual root cause of this is the network topology.  More specifically
\X'tty: link https://github.com/archlinux/archinstall/blob/e6344f93f7e476d05bbcd642f2ed91fdde545870/archinstall/lib/installer.py#L136'\fI\%timedatectl show\fP\X'tty: link' cannot perform a proper time sync against the default
servers.
.sp
Restarting \fBsystemd\-timesyncd.service\fP might work but most often you need
to configure \fB/etc/systemd/timesyncd.conf\fP to match your network design.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Se você sabe que a hora na máquina está correta, você pode executar
\fBarchinstall \-\-skip\-ntp\fP para ignorar a sincronização de hora.
.UNINDENT
.UNINDENT
.SS "Ausência do driver proprietário da Nvidia \X'tty: link https://github.com/archlinux/archinstall/issues/2002'\fI\%#2002\fP\X'tty: link'"
.sp
In some instances, the nvidia driver might not have all the necessary
packages installed.  This is due to the kernel selection and/or hardware
setups requiring additional packages to work properly.
.sp
Uma solução alternativa comum é instalar o pacote \X'tty: link https://archlinux.org/packages/core/x86_64/linux\-headers/'\fI\%linux\-headers\fP\X'tty: link' e \X'tty: link https://archlinux.org/packages/extra/x86_64/nvidia\-dkms/'\fI\%nvidia\-dkms\fP\X'tty: link'
.SS "Erro em CPUs ARM, 32 bits e outros tipos \X'tty: link https://github.com/archlinux/archinstall/issues/1686'\fI\%#1686\fP\X'tty: link', \X'tty: link https://github.com/archlinux/archinstall/issues/2185'\fI\%#2185\fP\X'tty: link'"
.sp
This is a bit of a catch\-all known issue.  Officially \X'tty: link https://wiki.archlinux.org/title/Frequently_asked_questions#What_architectures_does_Arch_support?'\fI\%x86_64\fP\X'tty: link' is only supported by Arch Linux.  Hence little effort have been put
into supporting other platforms.
.sp
In theory, other architectures should work but small quirks might arise.
.sp
PR\(aqs are welcome but please be respectful of the delays in merging.
Other fixes, issues or features will be prioritized for the above reasons.
.SS "O chaveiro está desatualizado \X'tty: link https://github.com/archlinux/archinstall/issues/2213'\fI\%#2213\fP\X'tty: link'"
.sp
Missing key\-issues tend to be that the \X'tty: link https://archlinux.org/packages/core/any/archlinux\-keyring/'\fI\%archlinux\-keyring\fP\X'tty: link' package is out of date, usually as a result of an outdated ISO.  There
is an attempt from upstream to fix this issue, and it\(aqs the \X'tty: link https://gitlab.archlinux.org/archlinux/archlinux\-keyring/\-/blob/7e672dad10652a80d1cc575d75cdb46442cd7f96/wkd_sync/archlinux\-keyring\-wkd\-sync.service.in'\fI\%archlinux\-keyring\-wkd\-sync.service\fP\X'tty: link'
.sp
The service starts almost immediately during boot, and if network is not
configured in time — the service will fail.  Subsequently the \fBarchinstall\fP
run might operate on a old keyring despite there being an update service for
this.
.sp
There is really no way to reliably over time work around this issue in
\fBarchinstall\fP\&.  Instead, efforts to the upstream service should be
considered the way forward. And/or keys not expiring between a sane amount
of ISO\(aqs.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
O problema também pode acontecer em novas ISOs, mesmo alguns dias após o
lançamento, pois algumas chaves podem expirar logo após o chaveiro ser
\fI"gravado"\fP na ISO.
.UNINDENT
.UNINDENT
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Outro problema comum relacionado à rede não estar configurada é que o tempo
pode não estar definido corretamente \- resultando na incapacidade de
atualização do chaveiro. Veja \fI\%Espera pela sincronização de tempo #2144\fP\&.
.UNINDENT
.UNINDENT
.SS "Pacotes AUR"
.sp
This is also a catch\-all issue.  \X'tty: link https://wiki.archlinux.org/title/Arch_User_Repository#Updating_packages'\fI\%AUR is unsupported\fP\X'tty: link', and until that changes we cannot use AUR
packages to solve feature requests in \fBarchinstall\fP\&.
.sp
This means that feature requests like supporting filesystems such as \X'tty: link https://aur.archlinux.org/packages/zfs\-linux'\fI\%ZFS\fP\X'tty: link' can
not be added, and issues cannot be solved by using AUR packages either.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
Mas com o espírito de dar opções à comunidade, \fBarchinstall\fP suporta
\fI\%plugins Python\fP, o que significa que você pode executar \fBarchinstall \-\-plugin <url>\fP e obter um plugin do AUR.
.sp
\X'tty: link https://github.com/torxed/archinstall\-aur'\fI\%torxed/archinstall\-aur\fP\X'tty: link' é uma implementação de referência para plugins:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# archinstall \-\-plugin https://archlinux.life/aur\-plugin
.EE
.UNINDENT
.UNINDENT
.sp
\X'tty: link https://github.com/phisch/archinstall\-aur'\fI\%phisch/archinstall\-aur\fP\X'tty: link' é outra alternativa:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# archinstall \-\-plugin https://raw.githubusercontent.com/phisch/archinstall\-aur/master/archinstall\-aur.py
.EE
.UNINDENT
.UNINDENT
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Isso permitirá o uso não suportado do AUR durante a instalação.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "RELATAR PROBLEMAS & BUGS"
.sp
Issues and bugs should be reported over at \X'tty: link https://github.com/archlinux/archinstall/issues'\fI\%https://github.com/archlinux/archinstall/issues\fP\X'tty: link'\&.
.sp
Perguntas gerais, melhorias e problemas de segurança também podem ser
relatados lá. Para problemas rápidos ou se precisar de ajuda, vá até o
servidor Discord que tem um canal de ajuda.
.SS "Arquivos log"
.sp
When submitting a help ticket, please include the
\fB/var/log/archinstall/install.log\fP\&.  It can be found both on the live ISO
but also in the installed filesystem if the base packages were strapped in.
.sp
\fBDICA:\fP
.INDENT 0.0
.INDENT 3.5
.nf
Uma maneira fácil de enviar logs é \fBcurl \-F\(aqfile=@/var/log/archinstall/install.log\(aq https://0x0.st\fP\&.
Tenha cuidado ao enviar outros arquivos de log, mas \fBarchinstall\fP promete manter \fBinstall.log\fP seguro para publicação pública!
.fi
.sp
.UNINDENT
.UNINDENT
.sp
There are additional log files under \fB/var/log/archinstall/\fP that can be
useful:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB/var/log/archinstall/user_configuration.json\fP \- Armazena a maioria das
respostas guiadas no instalador
.IP \(bu 2
\fB/var/log/archinstall/user_credentials.json\fP \- Armazena todos os nomes de
usuários ou senhas, podem ser passados ​​para \fB\-\-creds\fP
.IP \(bu 2
\fB/var/log/archinstall/user_disk_layouts.json\fP \- Armazena os discos
escolhidos e seus layouts
.IP \(bu 2
\fB/var/log/archinstall/install.log\fP \- Um arquivo de log sobre quais etapas
foram executadas pelo archinstall
.IP \(bu 2
\fB/var/log/archinstall/cmd_history.txt\fP \- Um histórico completo de comandos,
comando por comando, em ordem
.IP \(bu 2
\fB/var/log/archinstall/cmd_output.txt\fP \- Uma saída bruta de todos os
comandos que foram executados pelo archinstall
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Nós apenas tentamos garantir que \fB/var/log/archinstall/install.log\fP esteja
livre de informações sensíveis. Qualquer outro arquivo de log deve ser
fornecido com \fBo máximo cuidado\fP!
.UNINDENT
.UNINDENT
.SH DISCORD
.sp
Há um canal do Discord que é frequentado por alguns \X'tty: link https://github.com/archlinux/archinstall/graphs/contributors'\fI\%colaboradores\fP\X'tty: link'\&.
.sp
To join the server, head over to \X'tty: link https://discord.gg/aDeMffrxNg'\fI\%https://discord.gg/aDeMffrxNg\fP\X'tty: link' and join in.  There\(aqs not many rules other than common sense and to
treat others with respect. The general chat is for off\-topic things as well.
.sp
Há a função \fB@Party Animals\fP se você quiser notificações de novos
lançamentos que são postados no canal \fB#Release Party\fP. Outra coisa é que a
função \fB@Contributors\fP pode ser ativada por contribuidores escrevendo
\fB!verify\fP e seguindo o processo de verificação.
.sp
Entre, esperamos ver você lá! : )
.SH "BIBLIOTECA PYTHON"
.sp
O Archinstall é enviado em \X'tty: link https://pypi.org/'\fI\%PyPi\fP\X'tty: link' como \fI\%archinstall\fP\&. Mas a biblioteca também pode ser instalada
manualmente.
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Essas etapas não são necessárias se você quiser usar o archinstall no ISO
oficial do Arch Linux.
.UNINDENT
.UNINDENT
.SS "Instalando com pacman"
.sp
Archinstall está nos link \X'tty:
https://wiki.archlinux.org/index.php/Official_repositories'\fI\%repositórios oficiais\fP\X'tty: link'\&. E ele também instalará o archinstall como uma
biblioteca python.
.sp
Para instalar a biblioteca e o script archinstall:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pacman \-S archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Como alternativa, você pode instalar apenas a biblioteca e não o executável
auxiliar usando o pacote \fBpython\-archinstall\fP.
.SS "Installing from PyPI"
.sp
The basic concept of PyPI applies using \fIpip\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install archinstall
.EE
.UNINDENT
.UNINDENT
.SS "Instalando a partir do código\-fonte"
.sp
You can also install using the source code.  For sake of simplicity we will
use \fBgit clone\fP in this example.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
git clone https://github.com/archlinux/archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Você pode mover a pasta para o seu projeto e simplesmente fazer
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import archinstall
.EE
.UNINDENT
.UNINDENT
.sp
Ou você pode usar o \X'tty: link https://github.com/pypa/build'\fI\%build\fP\X'tty: link' e o \X'tty: link https://github.com/pypa/installer'\fI\%installer\fP\X'tty: link' do PyPA para
instalá\-lo no caminho do módulo do Python.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cd archinstall
$ python \-m build .
$ python \-m installer dist/*.whl
.EE
.UNINDENT
.UNINDENT
.SH "MÓDULO PYTHON"
.sp
O Archinstall suporta execução em \X'tty: link https://docs.python.org/3/library/__main__.html'\fI\%modo de módulo\fP\X'tty: link'\&. A maneira como a biblioteca é invocada no modo de módulo é limitada
à execução de scripts na pasta \X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link'.
.sp
Portanto, é importante colocar qualquer script ou perfil que você deseja
invocar na pasta de exemplos antes de compilar e instalar.
.SS Pré\-requisitos
.sp
Vamos supor que você seguiu o método \fI\%Instalando a partir do código\-fonte\fP. Antes de realmente instalar a biblioteca, você precisará
colocar seus scripts de instalação personalizados em \X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link' como um arquivo python.
.sp
Mais sobre como criá\-los na próxima seção.
.sp
\fBAVISO:\fP
.INDENT 0.0
.INDENT 3.5
Isso está sujeito a alterações no futuro, pois esse método é um pouco rígido
no momento. O caminho do script se tornará um parâmetro. Mas, por enquanto,
isso é por design.
.UNINDENT
.UNINDENT
.SS "Criando um script"
.sp
Vamos criar um \fItest_installer\fP \- instalador como exemplo. Isso pressupõe
que a pasta \fI\&./archinstall\fP seja um git\-clone do repositório
principal. Começamos criando "\X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link'\fB/test_installer.py\fP". O posicionamento aqui é importante mais tarde.
.sp
Este script agora já pode ser chamado usando \fBpython \-m archinstall test_installer\fP após uma instalação bem\-sucedida da biblioteca em si. Mas o
script não fará muita coisa. Então faremos algo simples como listar todos os
discos rígidos como um exemplo.
.sp
Para fazer isso, começaremos importando \fBarchinstall\fP em nosso "\X'tty: link https://github.com/archlinux/archinstall/tree/master/archinstall/scripts'\fI\%scripts\fP\X'tty: link'\fB/test_installer.py\fP" e chamaremos uma função em \fBarchinstall\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import archinstall

print(archinstall.disk.device_handler.devices)
.EE
.UNINDENT
.UNINDENT
.sp
Agora, vá em frente e faça referência ao método de instalação \fI\%Instalando a partir do código\-fonte\fP. Após executar \fBpython \-m archinstall test_installer\fP, ele deve imprimir algo parecido com:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[
    BDevice(
        disk=<parted.disk.Disk object at 0x7fbe17156050>,
        device_info=_DeviceInfo(
            model=\(aqPC801 NVMe SK hynix 512GB\(aq,
            path=PosixPath(\(aq/dev/nvme0n1\(aq),
            type=\(aqnvme\(aq,
            total_size=Size(value=512110190592, unit=<Unit.B: 1>,
            sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
            free_space_regions=[
                <archinstall.lib.disk.device_model.DeviceGeometry object at 0x7fbe166c4250>,
                <archinstall.lib.disk.device_model.DeviceGeometry object at 0x7fbe166c4c50>,
                <archinstall.lib.disk.device_model.DeviceGeometry object at 0x7fbe166c4a10>],
            sector_size=SectorSize(value=512, unit=<Unit.B: 1>),
            read_only=False,
            dirty=False
        ),
        partition_infos=[
            _PartitionInfo(
                partition=<parted.partition.Partition object at 0x7fbe166c4a90>,
                name=\(aqprimary\(aq,
                type=<PartitionType.Primary: \(aqprimary\(aq>,
                fs_type=<FilesystemType.Fat32: \(aqfat32\(aq>,
                path=\(aq/dev/nvme0n1p1\(aq,
                start=Size(value=2048, unit=<Unit.sectors: \(aqsectors\(aq>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                length=Size(value=535822336, unit=<Unit.B: 1>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                flags=[
                    <PartitionFlag.BOOT: flag_id=1, alias=None>,
                    <PartitionFlag.ESP: flag_id=18, alias=None>
                ],
                partn=1,
                partuuid=\(aqa26be943\-c193\-41f4\-9930\-9341cf5f6b19\(aq,
                uuid=\(aq6EE9\-2C00\(aq,
                disk=<parted.disk.Disk object at 0x7fbe17156050>,
                mountpoints=[
                    PosixPath(\(aq/boot\(aq)
                ],
                btrfs_subvol_infos=[]
            ),
            _PartitionInfo(...)
        ]
    )
]
.EE
.UNINDENT
.UNINDENT
.sp
Isso significa que seu script está no lugar certo e \fBarchinstall\fP está
funcionando conforme o esperado.
.sp
\fBNOTA:\fP
.INDENT 0.0
.INDENT 3.5
A maioria das chamadas, incluindo a acima, requer privilégios de \X'tty: link https://en.wikipedia.org/wiki/Superuser'\fI\%root\fP\X'tty: link'.
.UNINDENT
.UNINDENT
.SH "PLUGINS PYTHON"
.sp
\fBarchinstall\fP suporta plugins por meio de dois métodos.
.sp
O primeiro método é diretamente via parâmetro \fB\-\-plugin\fP ao executar como
uma ferramenta CLI. Isso carregará um plugin específico localmente ou
remotamente via um caminho.
.sp
O segundo método é via a \X'tty: link https://packaging.python.org/en/latest/specifications/entry\-points/'\fI\%descoberta de plugins\fP\X'tty: link' embutida do Python usando \X'tty: link https://docs.python.org/3/library/importlib.metadata.html#entry\-points'\fI\%pontos de entrada\fP\X'tty: link' categorizados como \fBarchinstall.plugin\fP\&.
.SS "Parâmetro \-\-plugin"
.sp
O parâmetro tem o benefício de ser armazenado no estado \fB\-\-conf\fP, o que
significa que ao executar novamente uma instalação — o plugin será carregado
automaticamente. Sua limitação é que ele requer que um caminho inicial seja
conhecido e escrito e seja trabalhoso.
.SS "Descoberta de plugins"
.sp
Este método permite que vários plugins sejam carregados com a desvantagem de
que eles precisam ser instalados previamente no sistema que executa
\fBarchinstall\fP\&. Isso tem como alvo principalmente aqueles que constroem
seus próprios ISOs e configurações específicas de pacotes para suas
necessidades.
.SS "O que é suportado?"
.sp
Atualmente, a documentação para isso é escassa. Até que isso seja resolvido,
a melhor maneira de encontrar recursos suportados é pesquisar o código\-fonte
para \X'tty: link https://github.com/search?q=repo%3Aarchlinux%2Farchinstall+%22plugin.on_%22&type=code'\fI\%plugin.on_\fP\X'tty: link', pois isso dará uma indicação clara de quais chamadas são feitas para
plugins.
.SS "Como ela funciona?"
.sp
Os plugins \fBarchinstall\fP usam uma abordagem orientada à descoberta, onde os
plugins são consultados para certas funções. Como exemplo, se um plugin tem
a seguinte função:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def on_pacstrap(*packages):
    ...
.EE
.UNINDENT
.UNINDENT
.sp
A função \fBarchinstall.Pacman().strap(["alguns pacotes"])\fP é codificada para
iterar plugins e procurar por \fBon_pacstrap\fP no plugin. Se a função existir,
\fB\&.strap()\fP chamará a função do plugin e substituirá a lista de pacotes
inicial pelo resultado do plugin.
.sp
A melhor maneira de documentar essas chamadas ainda não foi decidida, pois é
difícil documentar esse comportamento dinamicamente.
.SS "Escrevendo seu próprio?"
.sp
A maneira mais simples atualmente é olhar para uma implementação de
referência ou para a comunidade. Duas delas são:
.INDENT 0.0
.IP \(bu 2
\X'tty: link https://github.com/torxed/archinstall\-aur'\fI\%torxed/archinstall\-aur\fP\X'tty: link'
.IP \(bu 2
\X'tty: link https://github.com/phisch/archinstall\-aur'\fI\%phisch/archinstall\-aur\fP\X'tty: link'
.UNINDENT
.sp
E procurar por \X'tty: link https://github.com/search?q=repo%3Aarchlinux%2Farchinstall+%22plugin.on_%22&type=code'\fI\%plugin.on_\fP\X'tty: link' na base de código para descobrir o que \fBarchinstall\fP irá
procurar. Pull requests são bem\-vindas para ampliar o suporte para isso.
.SH ARCHINSTALL.INSTALLER
.sp
O instalador é a classe principal para acessar uma instância de
instalação. Você pode olhar para essa classe como a instalação que você tem
ou irá executar.
.sp
Qualquer coisa relacionada a \fBparte interna\fP da instalação será encontrada
nesta classe.
.INDENT 0.0
.TP 
\fBarchinstall.Installer(target: Path, disk_config: DiskLayoutConfiguration, disk_encryption: DiskEncryption | None = None, base_packages: list[str] = [], kernels: list[str] | None = None)\fP
.UNINDENT
.SH AUTOR
Anton Hvornum
.SH "DIREITOS AUTORAIS"
.\" Generated by docutils manpage writer.
2022, Anton Hvornum
.
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Rafael Fontenelle <rafaelff@gnome.org>
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .