APT-TRANSPORT-MIRR(1) APT APT-TRANSPORT-MIRR(1) NOME apt-transport-mirror - Transporte do APT para seleccao de mirror mais automatizada DESCRICAO Este transporte do APT nao esta por si so a implementar um protocolo para aceder a repositorios locais ou remotos, mas obtem uma mirrorlist e redireciona todos os pedidos para os mirro(s) retirados dessa lista, acedendo a eles via outros transportes como apt-transport-http(1). A funcionalidade basica esteve disponivel desde o apt 0.7.24, mas nao esteve documentada ate ao apt 1.6 o qual continha uma reconstrucao do transporte e das suas funcionalidades suportadas. Note que um transporte nunca e chamado directamente por um utilizador mas e usado pelas ferramentas do APT com base na configuracao do utilizador. Se a aquisicao de um ficheiro via um mirror falhar, o metodo assegura que outro mirror possivel da lista e tentado automaticamente ate que o ficheiro seja obtido ou nao houver mais nenhum mirror na lista lidando transparentemente com servidores desligados e problemas semelhantes. As implicacoes de seguranca do transporte dependem das consideracoes de seguranca associadas ao transporte usado para adquirir a mirrorlist e os transportes envolvidos no acesso ao(s) mirror(s) escolhidos pelo transporte. OPCOES Este transporte presentemente nao tem opcoes de configuracao. A seleccao do mirror e inteiramente baseada nos mirrors oferecidos na mirrorlist e nos ficheiros que o APT precisa de obter. Formato de mirrorlist Uma mirrorlist contem uma ou mais linhas cada uma especificando um URI para um mirror. Sao ignoradas as linhas vazias e aquelas comecadas com um cardinal (#). Um URI comeca sempre com um esquema URI que define o transporte usado para esse mirror. Se por exemplo o URI comecar com http:, o transporte responsavel e apt-transport-http(1) o qual pode ter requerimentos especificos para o formato da parte restante do URI. Podem ser fornecidos na mesma linha meta-dados acerca do mirror, separados do URI por um tab. Multiplos itens de meta-dados podem eles proprios serem separados por tabs ou espacos. (Esta e uma funcionalidade avancada apenas disponivel no apt >= 1.6. As versoes anteriores do apt irao falhar ao analisar mirrorlists que usem esta funcionalidade.) Desde o apt 1.6 que e tambem suportado o uso de mirrorlists comprimidas. Note que o nome do ficheiro da mirrorlist tem de especificar o algoritmo de compressao usado, nao ha auto-deteccao baseada no conteudo do ficheiro. Seleccao do Mirror por meta-dados Como especificado no formato, um mirror pode ter meta-dados adicionais acrescentados para impedir que um mirror seja selecionado para obter um ficheiro que nao corresponda a esses meta-dados. Deste modo a mirrorlist pode por exemplo conter mirrors parciais que servem apenas certas arquitecturas e o APT ira automaticamente escolher um mirror diferente para ficheiros que requeiram uma arquitectura nao listada. Sao suportados limites para a arquitectura (arch), nome de codigo do lancamento (codename), componente do repositorio onde o ficheiro esta (component), linguagem a que o ficheiro se aplica (lang), nome de suite do lancamento (suite) e o tipo do ficheiro (type). Ordem de recurso para mirrors Se nenhuma prioridade for dada para um mirror via chave de meta-dados priority, a ordem em que os mirrors sao contactados e aleatoria. Se um certo conjunto de mirrors deve ser tentado primeiro antes de qualquer outro, pode ser explicitamente definida uma prioridade. Os mirrors com o numero menor sao tentados primeiro. Os mirrors que nao tem prioridade explicita definida sao definidos com o numero mais alto possivel e assim sao tentados em ultimo. A escolha entre mirrors com a mesma prioridade e de novo aleatoria. Transportes permitidos numa mirrorlist A disponibilidade e escolha dos transportes numa mirrorlist esta limitada em como io cliente do APT esta a aceder a mirrorlist. Se for usado um transporte local como file ou copy, a mirrorlist tambem pode incluir fontes locais, enquanto que uma mirrorlist acedida via http nao pode. Adicionalmente, uma mirrorlist nao pode conter outra mirrorlist ou outros transportes de involucro (como apt-transport-tor). Veja a documentacao destes transportes em como os usar com o metodo de mirror. Note que as versoes do apt anteriores a 1.6 nao suportam mais nenhum transporte para alem de http. EXEMPLOS Exemplo basico Um exemplo de mirrorlist basico suportado por todas as versoes do apt com um metodo de mirror (>= 0.7.24) no qual o cliente ira pegar em qualquer um dos tres mirrors: http://ftp.de.debian.org/debian/ http://ftp.us.debian.org/debian/ http://deb.debian.org/debian/ Assumindo que um ficheiro com este conteudo esta armazenado em /etc/apt/mirrorlist.txt na sua maquina, pode ser usado desta maneira em sources.list(5) (desde o apt 1.6): deb mirror+file:/etc/apt/mirrorlist.txt trixie main Todas as versoes do metodo mirror suportam uma mirrorlist acessivel via HTTP, portanto assumindo que esta disponivel em http://apt.example.org/mirror.lst a entrada sources.list de cima podera, em vez dessa, ser escrita como: deb mirror://apt.example.org/mirror.lst trixie main Note que desde o apt 1.6 que o uso de mirror+http deve ser preferido a mirror para uniformidade. A funcionalidade e a mesma. Exemplo com seleccao de mirror de meta-dados-avancado Como explicado nas definicoes de formato as versoes do apt anteriores a 1.6 nao suportam isto e irao falhar ao analisar a mirrorlist. Este exemplo de mirrorlist e complicada intencionalmente para mostrar alguns aspectos da seleccao. E assumida a seguinte configuracao: O primeiro mirror e um mirror local acedido via metodo file, mas potencialmente incompleto. O segundo mirror tem uma boa ligacao, mas e um mirror parcial pois so contem ficheiros relacionados com as arquitecturas amd64 e all. Os restantes mirrors sao mirrors medios que sao devem ser contactados se os anteriores nao funcionarem. file:/srv/local/debian/mirror/ priority:1 type:index http://partial.example.org/mirror/ priority:2 arch:amd64 arch:all type:deb http://ftp.us.debian.org/debian/ type:deb http://ftp.de.debian.org/debian/ type:deb https://deb.debian.org/debian/ Nesta configuracao com esta mirrorlist o primeiro mirror sera usado para descarregar todos os ficheiros de indice assumindo que a propria mirrorlist e acedida via transporte local como file. Se nao o for, o mirror e caso contrario inacessivel ou se nao conter o ficheiro requisitado, sera usado outro mirror para obter o ficheiro, escolhido dependendo do tipo de ficheiro. Um ficheiro index sera servido pelo ultimo mirror da lista, enquanto um pacote da arquitectura amd64 e servido pelo segundo e aqueles, por exemplo, da arquitectura i386 por um dos ultimos tres. BUGS pagina de bugs do APT[1]. Se deseja reportar um bug no APT, por favor veja /usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1). TRADUCAO A traducao Portuguesa foi feita por Americo Monteiro de 2009 a 2012. A traducao foi revista pela equipa de traducoes portuguesas da Debian . Note que este documento traduzido pode conter partes nao traduzidas. Isto e feito propositadamente, para evitar perdas de conteudo quando a traducao esta atrasada relativamente ao conteudo original. AUTOR Equipa do APT NOTAS 1. pagina de bugs do APT https://bugs.debian.org/src:apt APT 3.3.0 09 Dezembro 2017 APT-TRANSPORT-MIRR(1)