ARCHINSTALL(1)                python-archinstall                ARCHINSTALL(1)

NOME
       archinstall - Documentacao do archinstall

       archinstall is library which can be used to install Arch Linux.  The
       library comes packaged with different pre-configured installers, such
       as the default Guided installation installer.

       A demo of the Guided installation installer can be seen here:
       https://www.youtube.com/watch?v=9Xt7X_Iqg6E.

       Alguns dos recursos do Archinstall sao:

       o Separacao em contextos. A biblioteca sempre executa chamadas em ordem
         sequencial para garantir que as etapas de instalacao nao se
         sobreponham ou sejam executadas na ordem errada. Ela tambem oferece
         suporte a (e usa) envoltorios de contexto para garantir que tarefas
         de limpeza e final, como mkinitcpio, sejam chamadas quando
         necessario.

       o Transparencia total Logs e insights podem ser encontrados em
         /var/log/archinstall tanto no ISO ativo quanto parcialmente no
         sistema instalado.

       o Acessivel O Archinstall funciona com espeakup e outras ferramentas de
         acessibilidade gracas ao uso de um TUI.

INSTALACAO GUIADA
       O Archinstall vem com um Instalador Guiado pre-programado que guia voce
       pelas etapas obrigatorias, bem como algumas configuracoes opcionais que
       podem ser feitas.

       NOTA:
          Outros scripts pre-programados podem ser invocados executando
          archinstall <script> (sem .py). Para ver uma lista completa de
          scripts, execute archinstall --script list ou verifique o diretorio
          scripts do codigo-fonte.

       NOTA:
          E recomendavel executar o archinstall a partir do ISO oficial do
          Arch Linux.

       AVISO:
          O instalador nao configurara o WiFi antes do inicio da instalacao.
          Voce precisa ler sobre conectividade no Arch Linux antes de
          continuar.

   Executando a instalacao guiada
       Para iniciar o instalador, execute o seguinte no ISO mais recente do
       Arch Linux:

          archinstall

       Como o Instalador Guiado e o script padrao, isso e o equivalente a
       executar archinstall guided

       A instalacao guiada tambem oferece suporte a instalacao com respostas
       pre-configuradas para todas as etapas guiadas. Esta pode ser uma
       maneira rapida e conveniente de executar novamente uma ou varias
       instalacoes.

       Ha dois arquivos de configuracao, ambos opcionais.

   --config
       Este parametro recebe um arquivo .json local ou remoto como argumento e
       contem a configuracao geral e as respostas do menu para o instalador
       guiado.

       NOTA:
          Voce sempre pode obter as opcoes mais recentes para este arquivo com
          archinstall --dry-run, que executa o instalador guiado em um modo
          seguro, onde nenhuma acao permanente sera tomada no seu sistema, mas
          simula uma execucao e salva a configuracao no disco.

   Exemplo de uso

          archinstall --config https://domain.lan/config.json

       O conteudo de https://domain.lan/config.json:

          {
              "__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"
          }

   Opcoes de --config
       AVISO:
          Todas as entradas de chave e valor devem estar em conformidade com o
          padrao JSON. Abaixo estao exemplos legiveis por humanos com links,
          quebrando efetivamente a sintaxe. Adapte as descricoes abaixo para
          atender as suas necessidades e ao formato JSON.

       NOTA:
          Role para a direita na tabela para ver as opcoes necessarias.

   Opcoes JSON

+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|Chave                   | Valor(es)                                                                                         | Descricao                                                                  | Obrigatorio   |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|additional-repositories | [ multilib, testing ]                                                                             | Habilita um ou mais repositorios de teste e multilib antes de prosseguir   | Nao           |
|                        |                                                                                                   | com a instalacao                                                           |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|archinstall-language    | lang                                                                                              | Define o idioma da interface de usuario de base texto (TUI) usado          | Nao           |
|                        |                                                                                                   | (certifique-se de usar o valor ``lang``, e nao ``abbr``)                   |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|audio_config            | pipewire, pulseaudio                                                                              | Servidor de audio a ser instalado                                          | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|bootloader              | Systemd-boot, grub                                                                                | Gerenciador de inicializacao a ser instalado (grub sendo obrigatorio em    | Sim           |
|                        |                                                                                                   | maquinas BIOS)                                                             |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|debug                   | true, false                                                                                       | Habilita saida de depuracao                                                | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|disk_config             | Leia mais em Configuracao de disco                                                                | Contem a configuracao de disco desejada a ser usada durante a instalacao   | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|disk_encryption         | Leia mais em Criptografia de disco                                                                | Parametros para criptografia de disco aplicados sobre disk_config          | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|hostname                | str                                                                                               | Uma string que define o nome de maquina da sua maquina na rede (o padrao e | Nao           |
|                        |                                                                                                   | ``archinstall``)                                                           |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|kernels                 | [ linux, linux-hardened, linux-lts, linux-rt, linux-rt-lts, linux-zen ]                           | Define quais kernels devem ser instalados e configurados nas opcoes do     | Sim           |
|                        |                                                                                                   | gerenciador de inicializacao                                               |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|custom-commands         | Leia mais em Comandos personalizados                                                              | Comandos personalizados que serao executados apos a instalacao com chroot  | Nao           |
|                        |                                                                                                   | dentro do sistema instalado                                                |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|locale_config           | {kb_layout: lang, sys_enc: Character encoding, sys_lang: locale}                                  | Define o mapa de teclas do teclado, a codificacao do sistema e a           | Nao           |
|                        |                                                                                                   | localidade do sistema                                                      |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|mirror_config           | {custom_mirrors: [ https://... ], mirror_regions: { "Worldwide": [                                | Define varios espelhos (o padrao e o ``/etc/pacman.d/mirrors`` da ISO, se  | Nao           |
|                        | "https://geo.mirror.pkgbuild.com/$repo/os/$arch" ] } }                                            | nao definido)                                                              |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|network_config          | `veja as opcoes em Configuracao de rede`                                                          | Define qual tipo de configuracao de rede (se houver) deve ser usado        | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|no_pkg_lookups          | true, false                                                                                       | Desabilita verificacao de pacotes em https://archlinux.org/packages/       | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|ntp                     | true, false                                                                                       | Habilita ou desabilita NTP durante a instalacao                            | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|offline                 | true, false                                                                                       | Habilita ou desabilita certas verificacoes online tal como alcance de      | Nao           |
|                        |                                                                                                   | espelhos etc.                                                              |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|packages                | [ <pacote1>, <pacote2>, ... ]                                                                     | Uma lista de pacotes para instalar durante a instalacao                    | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|parallel downloads      | 0-<infinity>                                                                                      | Define um determinado numero de downloads paralelos a serem usados         | Nao           |
|                        |                                                                                                   | <?><?>pelo pacman                                                          |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|profile_config          | `leia mais na secao de perfis`                                                                    | Instala um perfil dado se definido                                         | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|script                  | guided (padrao), minimal, only_hdd, swiss, unattended                                             | Quando usado para executar automaticamente uma instalacao, isso define     | Nao           |
|                        |                                                                                                   | qual script executar automaticamente                                       |               |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|silent                  | true, false                                                                                       | Desabilita ou habilita perguntas do usuario usando o TUI                   | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|swap                    | true, false                                                                                       | Habilita ou desabilita swap                                                | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
|timezone                | timezone                                                                                          | Define um fuso horario para o sistema instalado                            | Nao           |
+------------------------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+---------------+
       NOTA:
          Se nenhuma entrada for encontrada em disk_config, a instalacao
          guiada do archinstall usara o que estiver montado atualmente em
          /mnt/archinstall sem executar nenhuma operacao de disco.

   Opcoes para --creds
       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.

          {
              "!root-password" : "PapaiNoel2022"
          }

   Opcoes de --creds

     +---------------------+-----------------+------------------+---------------+
     |Chave                | Valores         | Descricao        | Obrigatorio   |
     +---------------------+-----------------+------------------+---------------+
     |!encryption-password | str             | Senha para       | Nao           |
     |                     |                 | criptografar o   |               |
     |                     |                 | disco, nao       |               |
     |                     |                 | criptografada se |               |
     |                     |                 | a senha nao for  |               |
     |                     |                 | fornecida        |               |
     +---------------------+-----------------+------------------+---------------+
     |!root-password       | str             | A senha da conta | Nao           |
     |                     |                 | root             |               |
     +---------------------+-----------------+------------------+---------------+
     |!users               | 0.0 3.5  {      | Lista de         | Talvez        |
     |                     | "username":     | credenciais de   |               |
     |                     | "<USUARIO>",    | usuarios         |               |
     |                     | "!password":    | regulares, veja  |               |
     |                     | "<SENHA>",      | a configuracao   |               |
     |                     | "sudo": false } | para referencia  |               |
     |                     | 168u  168u      |                  |               |
     +---------------------+-----------------+------------------+---------------+
       NOTA:
          !users e opcional somente se !root-password foi definido. !users
          sera imposto caso contrario e a quantidade minima de usuarios com
          privilegios sudo necessaria sera definida como 1.

       NOTA:
          As chaves comecam com ! porque as funcoes de log internas mascararao
          quaisquer chaves que comecem com explicacoes de logs e configuracoes
          irrestritas.

PROBLEMAS CONHECIDOS
       Some issues are out of the archinstall projects scope, and the ones we
       know of are listed below.

   Espera pela sincronizacao de tempo #2144
       The usual root cause of this is the network topology.  More
       specifically timedatectl show cannot perform a proper time sync against
       the default servers.

       Restarting systemd-timesyncd.service might work but most often you need
       to configure /etc/systemd/timesyncd.conf to match your network design.

       NOTA:
          Se voce sabe que a hora na maquina esta correta, voce pode executar
          archinstall --skip-ntp para ignorar a sincronizacao de hora.

   Ausencia do driver proprietario da Nvidia #2002
       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.

       Uma solucao alternativa comum e instalar o pacote linux-headers e
       nvidia-dkms

   Erro em CPUs ARM, 32 bits e outros tipos #1686, #2185
       This is a bit of a catch-all known issue.  Officially x86_64 is only
       supported by Arch Linux.  Hence little effort have been put into
       supporting other platforms.

       In theory, other architectures should work but small quirks might
       arise.

       PR's are welcome but please be respectful of the delays in merging.
       Other fixes, issues or features will be prioritized for the above
       reasons.

   O chaveiro esta desatualizado #2213
       Missing key-issues tend to be that the archlinux-keyring 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's the
       archlinux-keyring-wkd-sync.service

       The service starts almost immediately during boot, and if network is
       not configured in time -- the service will fail.  Subsequently the
       archinstall run might operate on a old keyring despite there being an
       update service for this.

       There is really no way to reliably over time work around this issue in
       archinstall.  Instead, efforts to the upstream service should be
       considered the way forward. And/or keys not expiring between a sane
       amount of ISO's.

       NOTA:
          O problema tambem pode acontecer em novas ISOs, mesmo alguns dias
          apos o lancamento, pois algumas chaves podem expirar logo apos o
          chaveiro ser "gravado" na ISO.

       NOTA:
          Outro problema comum relacionado a rede nao estar configurada e que
          o tempo pode nao estar definido corretamente - resultando na
          incapacidade de atualizacao do chaveiro. Veja Espera pela
          sincronizacao de tempo #2144.

   Pacotes AUR
       This is also a catch-all issue.  AUR is unsupported, and until that
       changes we cannot use AUR packages to solve feature requests in
       archinstall.

       This means that feature requests like supporting filesystems such as
       ZFS can not be added, and issues cannot be solved by using AUR packages
       either.

       NOTA:
          Mas com o espirito de dar opcoes a comunidade, archinstall suporta
          plugins Python, o que significa que voce pode executar archinstall
          --plugin <url> e obter um plugin do AUR.

          torxed/archinstall-aur e uma implementacao de referencia para
          plugins:

             # archinstall --plugin https://archlinux.life/aur-plugin

          phisch/archinstall-aur e outra alternativa:

             # archinstall --plugin https://raw.githubusercontent.com/phisch/archinstall-aur/master/archinstall-aur.py

          AVISO:
             Isso permitira o uso nao suportado do AUR durante a instalacao.

RELATAR PROBLEMAS & BUGS
       Issues and bugs should be reported over at
       https://github.com/archlinux/archinstall/issues.

       Perguntas gerais, melhorias e problemas de seguranca tambem podem ser
       relatados la. Para problemas rapidos ou se precisar de ajuda, va ate o
       servidor Discord que tem um canal de ajuda.

   Arquivos log
       When submitting a help ticket, please include the
       /var/log/archinstall/install.log.  It can be found both on the live ISO
       but also in the installed filesystem if the base packages were strapped
       in.

       DICA:
          Uma maneira facil de enviar logs e curl -F'file=@/var/log/archinstall/install.log' https://0x0.st.
          Tenha cuidado ao enviar outros arquivos de log, mas archinstall promete manter install.log seguro para publicacao publica!


       There are additional log files under /var/log/archinstall/ that can be
       useful:

          o /var/log/archinstall/user_configuration.json - Armazena a maioria
            das respostas guiadas no instalador

          o /var/log/archinstall/user_credentials.json - Armazena todos os
            nomes de usuarios ou senhas, podem ser passados <?><?>para --creds

          o /var/log/archinstall/user_disk_layouts.json - Armazena os discos
            escolhidos e seus layouts

          o /var/log/archinstall/install.log - Um arquivo de log sobre quais
            etapas foram executadas pelo archinstall

          o /var/log/archinstall/cmd_history.txt - Um historico completo de
            comandos, comando por comando, em ordem

          o /var/log/archinstall/cmd_output.txt - Uma saida bruta de todos os
            comandos que foram executados pelo archinstall

       AVISO:
          Nos apenas tentamos garantir que /var/log/archinstall/install.log
          esteja livre de informacoes sensiveis. Qualquer outro arquivo de log
          deve ser fornecido com o maximo cuidado!

DISCORD
       Ha um canal do Discord que e frequentado por alguns colaboradores.

       To join the server, head over to https://discord.gg/aDeMffrxNg and join
       in.  There's not many rules other than common sense and to treat others
       with respect. The general chat is for off-topic things as well.

       Ha a funcao @Party Animals se voce quiser notificacoes de novos
       lancamentos que sao postados no canal #Release Party. Outra coisa e que
       a funcao @Contributors pode ser ativada por contribuidores escrevendo
       !verify e seguindo o processo de verificacao.

       Entre, esperamos ver voce la! : )

BIBLIOTECA PYTHON
       O Archinstall e enviado em PyPi como archinstall. Mas a biblioteca
       tambem pode ser instalada manualmente.

       AVISO:
          Essas etapas nao sao necessarias se voce quiser usar o archinstall
          no ISO oficial do Arch Linux.

   Instalando com pacman
       Archinstall esta nos link
       https://wiki.archlinux.org/index.php/Official_repositories'repositorios
       oficiais. E ele tambem instalara o archinstall como uma biblioteca
       python.

       Para instalar a biblioteca e o script archinstall:

          pacman -S archinstall

       Como alternativa, voce pode instalar apenas a biblioteca e nao o
       executavel auxiliar usando o pacote python-archinstall.

   Installing from PyPI
       The basic concept of PyPI applies using pip.

          pip install archinstall

   Instalando a partir do codigo-fonte
       You can also install using the source code.  For sake of simplicity we
       will use git clone in this example.

          git clone https://github.com/archlinux/archinstall

       Voce pode mover a pasta para o seu projeto e simplesmente fazer

          import archinstall

       Ou voce pode usar o build e o installer do PyPA para instala-lo no
       caminho do modulo do Python.

          $ cd archinstall
          $ python -m build .
          $ python -m installer dist/*.whl

MODULO PYTHON
       O Archinstall suporta execucao em modo de modulo. A maneira como a
       biblioteca e invocada no modo de modulo e limitada a execucao de
       scripts na pasta scripts.

       Portanto, e importante colocar qualquer script ou perfil que voce
       deseja invocar na pasta de exemplos antes de compilar e instalar.

   Pre-requisitos
       Vamos supor que voce seguiu o metodo Instalando a partir do
       codigo-fonte. Antes de realmente instalar a biblioteca, voce precisara
       colocar seus scripts de instalacao personalizados em scripts como um
       arquivo python.

       Mais sobre como cria-los na proxima secao.

       AVISO:
          Isso esta sujeito a alteracoes no futuro, pois esse metodo e um
          pouco rigido no momento. O caminho do script se tornara um
          parametro. Mas, por enquanto, isso e por design.

   Criando um script
       Vamos criar um test_installer - instalador como exemplo. Isso pressupoe
       que a pasta ./archinstall seja um git-clone do repositorio principal.
       Comecamos criando "scripts/test_installer.py". O posicionamento aqui e
       importante mais tarde.

       Este script agora ja pode ser chamado usando python -m archinstall
       test_installer apos uma instalacao bem-sucedida da biblioteca em si.
       Mas o script nao fara muita coisa. Entao faremos algo simples como
       listar todos os discos rigidos como um exemplo.

       Para fazer isso, comecaremos importando archinstall em nosso
       "scripts/test_installer.py" e chamaremos uma funcao em archinstall.

          import archinstall

          print(archinstall.disk.device_handler.devices)

       Agora, va em frente e faca referencia ao metodo de instalacao
       Instalando a partir do codigo-fonte. Apos executar python -m
       archinstall test_installer, ele deve imprimir algo parecido com:

          [
              BDevice(
                  disk=<parted.disk.Disk object at 0x7fbe17156050>,
                  device_info=_DeviceInfo(
                      model='PC801 NVMe SK hynix 512GB',
                      path=PosixPath('/dev/nvme0n1'),
                      type='nvme',
                      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='primary',
                          type=<PartitionType.Primary: 'primary'>,
                          fs_type=<FilesystemType.Fat32: 'fat32'>,
                          path='/dev/nvme0n1p1',
                          start=Size(value=2048, unit=<Unit.sectors: 'sectors'>, 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='a26be943-c193-41f4-9930-9341cf5f6b19',
                          uuid='6EE9-2C00',
                          disk=<parted.disk.Disk object at 0x7fbe17156050>,
                          mountpoints=[
                              PosixPath('/boot')
                          ],
                          btrfs_subvol_infos=[]
                      ),
                      _PartitionInfo(...)
                  ]
              )
          ]

       Isso significa que seu script esta no lugar certo e archinstall esta
       funcionando conforme o esperado.

       NOTA:
          A maioria das chamadas, incluindo a acima, requer privilegios de
          root.

PLUGINS PYTHON
       archinstall suporta plugins por meio de dois metodos.

       O primeiro metodo e diretamente via parametro --plugin ao executar como
       uma ferramenta CLI. Isso carregara um plugin especifico localmente ou
       remotamente via um caminho.

       O segundo metodo e via a descoberta de plugins embutida do Python
       usando pontos de entrada categorizados como archinstall.plugin.

   Parametro --plugin
       O parametro tem o beneficio de ser armazenado no estado --conf, o que
       significa que ao executar novamente uma instalacao -- o plugin sera
       carregado automaticamente. Sua limitacao e que ele requer que um
       caminho inicial seja conhecido e escrito e seja trabalhoso.

   Descoberta de plugins
       Este metodo permite que varios plugins sejam carregados com a
       desvantagem de que eles precisam ser instalados previamente no sistema
       que executa archinstall. Isso tem como alvo principalmente aqueles que
       constroem seus proprios ISOs e configuracoes especificas de pacotes
       para suas necessidades.

   O que e suportado?
       Atualmente, a documentacao para isso e escassa. Ate que isso seja
       resolvido, a melhor maneira de encontrar recursos suportados e
       pesquisar o codigo-fonte para plugin.on_, pois isso dara uma indicacao
       clara de quais chamadas sao feitas para plugins.

   Como ela funciona?
       Os plugins archinstall usam uma abordagem orientada a descoberta, onde
       os plugins sao consultados para certas funcoes. Como exemplo, se um
       plugin tem a seguinte funcao:

          def on_pacstrap(*packages):
              ...

       A funcao archinstall.Pacman().strap(["alguns pacotes"]) e codificada
       para iterar plugins e procurar por on_pacstrap no plugin. Se a funcao
       existir, .strap() chamara a funcao do plugin e substituira a lista de
       pacotes inicial pelo resultado do plugin.

       A melhor maneira de documentar essas chamadas ainda nao foi decidida,
       pois e dificil documentar esse comportamento dinamicamente.

   Escrevendo seu proprio?
       A maneira mais simples atualmente e olhar para uma implementacao de
       referencia ou para a comunidade. Duas delas sao:

       o torxed/archinstall-aur

       o phisch/archinstall-aur

       E procurar por plugin.on_ na base de codigo para descobrir o que
       archinstall ira procurar. Pull requests sao bem-vindas para ampliar o
       suporte para isso.

ARCHINSTALL.INSTALLER
       O instalador e a classe principal para acessar uma instancia de
       instalacao. Voce pode olhar para essa classe como a instalacao que voce
       tem ou ira executar.

       Qualquer coisa relacionada a parte interna da instalacao sera
       encontrada nesta classe.

       archinstall.Installer(target: Path, disk_config:
       DiskLayoutConfiguration, disk_encryption: DiskEncryption | None = None,
       base_packages: list[str] = [], kernels: list[str] | None = None)

AUTOR
       Anton Hvornum

DIREITOS AUTORAIS
       2022, Anton Hvornum

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Rafael Fontenelle <rafaelff@gnome.org>

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

                               November 23, 2024                ARCHINSTALL(1)