I repository ed il loro utilizzo: differenze tra le versioni

→‎Sources.list: mirror security - vecchia sintassi non più supportata - modificato avviso con Cautionbox
(→‎Sources.list: mirror security - vecchia sintassi non più supportata - modificato avviso con Cautionbox)
 
(147 versioni intermedie di 5 utenti non mostrate)
Riga 1: Riga 1:
{{Repository
{{Repository
|successivo_rep=Repository & pinning
|successivo=Repository & pinning
}}
}}
{{Versioni compatibili}}
{{Versioni compatibili}}
__TOC__
{{Box|Nota importante|Prima di procedere con la lettura della presente guida è fondamentale che il lettore abbia chiara la struttura di Debian. Si veda ad esempio [[La struttura della Distribuzione | questa guida]].}}
== Introduzione ==
== Introduzione ==
Il [[repository]] è a tutti gli effetti un archivio ordinato dove sono raccolti i pacchetti Debian (siano essi pacchetti binari o sorgenti) in modo ben organizzato e costantemente aggiornato. In ogni sistema Debian i repository utilizzati vengono indicati nel file <code>/etc/apt/sources.list</code>. Vedi anche [[Faq#Repository|FAQ: Cos'è un '''repository'''?]].
Dopo aver installato una Debian nasce il bisogno di aggiungere nuovi programmi e allo stesso tempo di tenerla costantemente aggiornata.<br />
Per questo scopo Debian dispone di un tool potentissimo: [[APT]] (Advanced Packaging Tool), con numerosi strumenti sia da riga di comando (la shell), come [[apt]], [[apt-get]], [[aptitude]], dselect, [[wajig]], sia per mezzo di interfacce grafiche come aptitude, [[synaptic]], PackageKit e altri.<br />
A prescindere dallo strumento usato il cuore del sistema, cioè i [[pacchetto|pacchetti]] (i "programmi"), è comune. Il [[repository]] è a tutti gli effetti un archivio ordinato dove sono raccolti i pacchetti Debian (siano essi pacchetti binari o sorgenti) in modo ben organizzato e costantemente aggiornato, si veda anche [[FAQ#Repository|FAQ: Cos'è un '''repository'''?]].


== La Struttura dei repository ==
Per comprendere appieno tutto il meccanismo delle installazioni e degli aggiornamenti bisogna conoscere com'è strutturata una Debian. Questo articolo vuole essere un'introduzione alla comprensione della struttura per la gestione degli oltre 40.000 pacchetti che Debian offre. Per approfondimenti consultare le ricche pagine di [[Documentazione Debian|documentazione]] che accompagnano Debian come ''debian-reference-it'', ''debian-faq-it'', etc.
Un repository è suddivisibile, grossomodo, in due sezioni:
 
* '''dists''' in questo ramo sono contenuti i file di controllo, che permettono il funzionamento del sistema di pacchettizzazione. Infatti sono presenti i file che descrivono i pacchetti presenti nell'archivio (divisi per la release di appartenenza);
== Organizzazione e struttura ==
Un repository (per esempio: {{APT-mirror|main}}) è suddiviso nei seguenti rami:
* '''dists''' contiene i file di controllo, che permettono il funzionamento del sistema di pacchettizzazione. Infatti sono presenti i file che descrivono i pacchetti presenti nell'archivio (divisi per la release di appartenenza);
* '''doc''' raccoglie la documentazione di base per Debian (segnalazioni di Bug, Faq, il Contratto Sociale ed altro);
* '''doc''' raccoglie la documentazione di base per Debian (segnalazioni di Bug, Faq, il Contratto Sociale ed altro);
* '''indices''' contiene l'indice di tutti i file contenuti in tutti i pacchetti. Queste informazioni sono usate da [[Apt-file: ricerca all'interno dei pacchetti|<code>apt-file</code>]];
* '''indices''' contiene l'indice di tutti i file contenuti in tutti i pacchetti. Queste informazioni sono usate da [[Apt-file: ricerca all'interno dei pacchetti|<code>apt-file</code>]];
* '''non-US''' a causa di problemi legali dovuti al divieto di esportazione di materiale per la difesa (tra cui materiale crittografici, utilizzati anche in PGP e SSH). Per ovviare a questi problemi, i pacchetti sono stati posti in una sezione a parte, la cui distribuzione è legata a server non statunitensi;
* '''pool''' questo è l'archivio vero e proprio, dove sono contenuti i pacchetti, raggruppati per lettera iniziale;
* '''pool''' questo è l'archivio vero e proprio, dove sono contenuti i pacchetti, raggruppati per lettera iniziale;
* '''project''' contiene materiale per sviluppatori. Degne di nota la directory experimental, che contiene i pacchetti in fase di sviluppo e perfezionamento;<br/>
* '''project''' contiene materiale per sviluppatori. Degne di nota la directory experimental, che contiene i pacchetti in fase di sviluppo e perfezionamento;
* '''tools''' contiene degli strumenti Dos per la creazione di dischetti di boot, partizionamento e lancio di Linux.
* '''tools''' contiene degli strumenti DOS per la creazione di dischetti di boot, partizionamento e lancio del sistema.
 
==== Il file "Release" ====
Ogni repository ha un file ''Release'' contenente diverse informazioni fondamentali per l'utilizzo da parte di [[APT]].
 
È possibile accedere al file ''Release'' di un repository alla pagina Internet: <code>INDIRIZZO'''/dists/'''DISTRIBUZIONE'''/Release'''</code>, dove ''INDIRIZZO'' e ''DISTRIBUZIONE'' fanno riferimento ai valori del repository da cercare.


== La Suddivisione del repository ==
Per esempio nel caso del repository principale della [[stable]]:
Navigando un po' tra gli archivi Debian, si nota subito una particolare suddivisione: i repository, infatti, sono divisi in '''main''', '''contrib''' e '''non-free''', nel modo seguente:
* l'indirizzo è {{APT-mirror}}, ma quello di qualsiasi [[mirror]] sarebbe equivalente;
* '''main''' è la sezione principale, che contiene il 90% dei pacchetti presenti in Debian;
* come distribuzione si può usare sia il [[codename]] (attualmente '''{{Codename|stable}}''') che il nome della [[suite]] ('''stable''');
* '''contrib''' raccoglie i pacchetti coerenti con i punti 5 e/o 6 delle [[DFSG]], ma che dipendono da pacchetti che non la rispettano;
il suo file ''Release'' è consultabile all'indirizzo http://ftp.debian.org/debian/dists/{{Codename|stable}}/Release ; per esempio quello di Debian 10 ([[Buster]]), {{#switch: {{Codename|Buster}}
* '''non-free''' contiene dei pacchetti che possiedono delle limitazioni nella distribuzione (ad esempio perché non utilizzabili in ambito commerciale o perché dipendenti da applicazioni o pacchetti che non rispettano la [[DFSG|Debian Free Software Guidelines]]) <br><br>
| stable = appena rilasciata
| obsoleta = ormai obsoleta, quando era la ''stable'' ed era appena stata rilasciata
| attualmente la [[{{Codename|Buster}}]], quando era la ''stable'' ed era appena stata rilasciata }} conteneva:
<pre>
Origin: Debian
Label: Debian
Suite: stable
Version: 10.0
Codename: buster
Changelogs: http://metadata.ftp-master.debian.org/changelogs/@CHANGEPATH@_changelog
Date: Sat, 06 Jul 2019 09:08:16 UTC
Acquire-By-Hash: yes
Architectures: amd64 arm64 armel armhf i386 mips mips64el mipsel ppc64el s390x
Components: main contrib non-free
Description: Debian 10.0 Released 06 July 2019
...
</pre>
Dove:
* '''Origin''' specifica il proprietario del repository. Se si fa uso del [[pinning]] si può sfruttare questo dato inserendo la riga <code>Pin: release o=</code> In <code>preferences</code>.
* '''Label''' identifica il repository: potete inserire descrizioni, ecc. Se si fa uso del pinning si può sfruttare questo dato inserendo la riga <code>Pin: release l=</code> In <code>preferences</code>.
* '''Suite''' (o anche ''Archive'') è l'archivio Debian a cui i pacchetti appartengono (ad es.: stable, testing. ecc.). Se si fa uso del pinning si può sfruttare questo dato inserendo la riga <code>Pin: release a=</code> In <code>preferences</code>.
* '''Version''' indica la versione corrente, e nel caso di Buster all'inizio è 10.0 e poi sarà aumentata a ogni nuova ''point release'' (10.1, 10.2, ...), ma sempre mantenendo la prima cifra fino all'arrivo della [[stable]] successiva.
* '''Codename''' specifica il nome in codice della release. Se si fa uso del pinning si può sfruttare questo dato inserendo la riga <code>Pin: release n=</code> In <code>preferences</code>.
* '''Architectures''' elenca le [[architettura|architetture]] dei pacchetti contenuti nel repository (ad es.: i386, sparc, source, ecc.).
* '''Components''' riporta la lista delle sezioni (per i repository ufficiali: 'main'', ''contrib'', ''non-free'');


{{Box|Nota che...|...Debian promuove e percorre il sentiero del software totalmente libero; l'uso delle sezioni '''contrib''' e '''non-free''' è una scelta personale e non un obbligo.}}
In maniera analoga è possibile consultare le informazioni di ogni altro repository, utilizzando l'indirizzo e il codename corrispondente. Inoltre queste informazioni sui repository sono presenti, e se necessario spiegate, anche nelle guide di questa wiki, accessibili dal menù in alto in questa pagina.


{{Box|Nota|Parte di queste informazioni possono essere ottenute anche usando il comando:
<pre>$ apt-cache policy</pre>
che mostra anche i pin dei repository e/o quelli manualmente definiti dall'utente.}}


== Sources.list ==
==== Sezioni ====
La gestione dei repository avviene principalmente tramite modifiche al file <code>'''/etc/apt/sources.list'''</code>, questo è forse il più importante file di configurazione del sistema di gestione dei pacchetti Debian; contiene infatti l'elenco e gli indirizzi dei repository a cui apt accede.
I repository ufficiali sono divisi in tre [[sezione|sezioni]] (dette anche aree o componenti):
* [[main]] è la principale, e l'unica sia necessaria che autosufficiente. I pacchetti di '''main''' non dipendono dalle altre sezioni e nemmeno da materiale esterno a Debian, né per l'esecuzione né per la compilazione dei sorgenti.<br/>È composta soltanto dai pacchetti che rispettano completamente le [[DFSG|Debian Free Software Guidelines]], che garantiscono che il software presente è [[Software Libero]] (e quindi anche Open Source) e che ogni altro materiale (documentazione, dati, musica, ecc.) presente è ridistribuibile alle stesse condizioni;
* [[contrib]] raccoglie i pacchetti che sono coerenti con le [[DFSG]] ma che dipendono da software o altro materiale che non le rispetta, per l'esecuzione o per la compilazione;
* [[non-free]] contiene i pacchetti che non rispettano, in tutto o in parte, le [[DFSG]].<br>


=== Ordine di Inserimento ===
In caso si scelga di abilitare la sezione ''contrib'', oppure sia ''contrib'' che ''non-free'', si deve farlo sempre in aggiunta a quella '''main'''.
È importante inserire i repository con un giusto ordine: i primi in elenco, infatti, sono i più importanti (o favoriti). Per migliorare le performance, è consigliabile ordinarli per velocità (es. prima il CD-ROM, poi la rete locale, poi internet, ecc.).


Se non si hanno esigenze particolari, gli utenti che installano Debian da CD o DVD possono cancellare o commentare le righe corrispondenti a queste sorgenti in <code>/etc/apt/sources.list</code> subito dopo l'installazione. Il motivo è dovuto al fatto che i pacchetti che si trovano su questi supporti sono rapidamente superati dagli aggiornamenti presenti nei [[repository ufficiali]]; questi ultimi, se assenti, vanno ovviamente aggiunti manualmente ad <code>/etc/apt/sources.list </code>.
{{Box|Nota che...|...Debian promuove e percorre il sentiero del software totalmente libero; l'uso delle sezioni '''contrib''' e '''non-free''' è una scelta personale e non un obbligo. In particolare abilitare anche la sola sezione ''contrib'' '''non''' garantisce che tutto il software installato sul proprio sistema sia [[Software Libero]].


Ogni volta che si aggiunge o si rimuove un repository dal file <code>sources.list</code> è necessario impartire il comando:
A partire da Debian 6 (Squeeze) con l'uso della sola sezione '''main''' anche il kernel è completamente libero, mentre in precedenza poteva contenere blob binari, per esempio i [[firmware]] senza codice sorgente per alcuni dispositivi.}}
<pre># apt-get update</pre>
oppure:
<pre># aptitude update</pre>
per aggiornare la lista dei pacchetti.


=== Sintassi ===
=== Sources.list ===
<!--
  NOTA: *NON* cambiare il nome della sezione "Sources.list", perché è utilizzata da altre guide
-->
La gestione dei [[repository]] avviene principalmente tramite modifiche al file <code>'''/etc/apt/sources.list'''</code>, questo è il più importante file di configurazione del sistema di gestione dei pacchetti Debian; contiene infatti l'elenco e gli indirizzi dei repository a cui [[APT]] accede per il download dei pacchetti binari e sorgenti.
 
In aggiunta a tale file possono esisterne altri con estensione <code>.list</code> all'interno della directory <code>/etc/apt/sources.list.d</code>, pensata per contenere i [[repository]] di terze parti. Questa directory dovrebbe essere vuota, se non si è installato nulla che la modifichi e non si sono aggiunti dei file manualmente.
 
==== Modifiche ai file di configurazione ====
Non esiste un unico modo per aggiungere, modificare o rimuovere repository, ma sono sempre richiesti [[privilegi di amministrazione]]. A partire da Debian 8 [[Jessie]] è raccomandabile utilizzare [[apt]] per modificare il file principale (<code>/etc/apt/sources.list</code>):
<pre># apt edit-sources</pre>
perché effettua anche un controllo della sintassi prima di apportare le modifiche con il proprio editor preferito. Nel caso di [[nano]], il più semplice da usare, dopo aver effettuato le modifiche basta premere Ctrl-o per salvare e Ctrl-x per uscire.
 
Per modificare invece i file .list in <code>/etc/apt/sources.list.d</code> è necessario utilizzare un editor esterno, in questo caso <code>nano</code>:
<pre>
# nano /etc/apt/sources.list.d/NOME-DEL-FILE.list
</pre>
 
Si ricordi sempre che ogni volta che si aggiunge o si rimuove un repository è necessario anche aggiornare la lista dei [[pacchetto|pacchetti]] del sistema. Per esempio eseguendo con [[privilegi di amministrazione]]:
<pre>
# apt update
</pre>
Tale lista va inoltre tenuta aggiornata periodicamente, in particolare prima di effettuare aggiornamenti o nuove installazioni.
 
==== Ordine di inserimento ====
È importante inserire i repository con un giusto ordine: i primi in elenco, infatti, sono i più importanti (o favoriti). Per migliorare le prestazioni, è consigliabile ordinarli per velocità (es. prima il CD-ROM, poi la rete locale, poi Internet, ecc.).
 
Se non si hanno esigenze particolari, gli utenti che installano Debian da CD o DVD possono cancellare o commentare le righe corrispondenti a queste sorgenti in <code>/etc/apt/sources.list</code> subito dopo l'installazione. Il motivo è dovuto al fatto che i pacchetti che si trovano su questi supporti sono rapidamente superati dagli aggiornamenti presenti nei [[repository ufficiali]]; questi ultimi, se assenti, vanno ovviamente aggiunti manualmente ad <code>/etc/apt/sources.list</code>.
 
==== Sintassi ====
Ogni riga che descrive un repository ha una ben determinata sintassi:
Ogni riga che descrive un repository ha una ben determinata sintassi:
<pre>
<pre>
Riga 49: Riga 115:
* <code>'''URI'''</code>: indica l'indirizzo a cui è possibile trovare il repository; è possibile scegliere tra i seguenti metodi di accesso ai pacchetti:
* <code>'''URI'''</code>: indica l'indirizzo a cui è possibile trovare il repository; è possibile scegliere tra i seguenti metodi di accesso ai pacchetti:
** <code>'''file'''</code>: permette di inserire un repository presente sul disco rigido del computer;
** <code>'''file'''</code>: permette di inserire un repository presente sul disco rigido del computer;
** <code>'''cdrom'''</code>: permette di inserire un repository presente su un cd-rom;
** <code>'''cdrom'''</code>: permette di inserire un repository presente su un CD-ROM o DVD-ROM;
** <code>'''http'''</code>: permette di accedere ad un repository tramite il protocollo HTTP (se è impostata una variabile di ambiente <code>'''http_proxy'''</code> col formato <code>'''http://server:port/'''</code> verranno usate queste opzioni per accedere al repository; in caso di necessità di autenticazione, è possibile specificare l'indirizzo del proxy, nella variabile d'ambiente <code>'''http_proxy'''</code>, nel seguente modo: <code>'''http://user:pass@server:port/'''</code>, anche se risulta non essere un modo sicuro di autenticazione);
** <code>'''http'''</code>: permette di accedere ad un repository tramite il protocollo HTTP (se è impostata una variabile di ambiente <code>'''http_proxy'''</code> col formato '''<code><nowiki>http://server:port/</nowiki></code>''' verranno usate queste opzioni per accedere al repository; in caso di necessità di autenticazione, è possibile specificare l'indirizzo del proxy, nella variabile d'ambiente <code>'''http_proxy'''</code>, nel seguente modo: '''<code><nowiki>http://user:pass@server:port/</nowiki></code>''', anche se risulta non essere un modo sicuro di autenticazione);
** <code>'''ftp'''</code>: permette di accedere ad un repository tramite il protocollo FTP; è possibile specificare un proxy nello stesso modo indicato per http al punto precedente, sostituendo alla variabile <code>'''http_proxy'''</code> <code>'''ftp_proxy'''</code>;
** <code>'''ftp'''</code>: permette di accedere ad un repository tramite il protocollo FTP; è possibile specificare un proxy nello stesso modo indicato per http al punto precedente, sostituendo alla variabile <code>'''http_proxy'''</code> <code>'''ftp_proxy'''</code>;
** <code>'''copy'''</code>: è identico a file, ma i file utilizzati vengono salvati nella cache di apt; utile nel caso di supporti removibili quali chiavette USB, floppy, memorie SD, ecc.;
** <code>'''copy'''</code>: è identico a file, ma i file utilizzati vengono salvati nella cache di apt; utile nel caso di supporti removibili quali chiavette USB, floppy, memorie SD, ecc.;
** <code>'''rsh, ssh'''</code>: permette di accedere ad un repository tramite il protocollo SSH. Non è possibile, però, effettuare alcuna autenticazione interattiva, ma solo tramite lo scambio di chiavi RSA;
** <code>'''rsh, ssh'''</code>: permette di accedere ad un repository tramite il protocollo [[SSH]]. Non è possibile, però, effettuare alcuna autenticazione interattiva, ma solo tramite lo scambio di chiavi [[RSA]];
* <code>'''distribuzione'''</code>: indica la [[La struttura della Distribuzione|distribuzione (o release)]] utilizzata, è possibile usare il nome in codice (<code>lenny</code>, <code>squeeze</code>, <code>sid</code>) o il nome generico (<code>stable</code>, <code>testing</code>, <code>unstable</code>);
* <code>'''distribuzione'''</code>: corrisponde alla [[release]] utilizzata dal repository, ed è possibile usare sia il [[codename]] che il nome della [[suite]]. Fanno eccezione i repository di sicurezza, che richiedono il valore ''codename'''''/updates''' oppure ''suite'''''/updates''', anche se utilizzano gli stessi ''codename'' e ''suite'' del repository principale;
* <code>'''componente/i'''</code>: indica le sezioni (<code>main</code>, <code>contrib</code>, <code>non-free</code>) del repository da inserire; sono possibili scelte multiple.
* <code>'''componente/i'''</code>: indica le sezioni (<code>main</code>, <code>contrib</code>, <code>non-free</code>) del repository da inserire; sono possibili scelte multiple.


=== Alcuni esempi ===
==== Alcuni esempi ====
Non c'è niente di meglio, per capire la sintassi del file <code>sources.list</code>, di un po' di esempi.
Non c'è niente di meglio, per capire la sintassi del file <code>sources.list</code>, di un po' di esempi.


I repository ufficiali (binari e sorgenti) presi da un mirror italiano:
I repository ufficiali di Debian {{Codename|versione_stable}} ([[{{Codename|Stable}}]]) con solo software libero (binari e sorgenti) presi dal mirror {{APT-mirror|descrizione}}:
<pre>
 
deb http://ftp.it.debian.org/debian/ stable main
deb {{APT-mirror}} {{Codename|stable}} main
deb-src http://ftp.it.debian.org/debian/ stable main
deb-src {{APT-mirror}} {{Codename|stable}} main
</pre>
 
E repository relativo di sicurezza:
 
# Sicurezza
deb {{APT-mirror|security}} {{Codename|stable}}{{#ifeq: {{Codename|stable}} | buster | /updates | -security }} main
deb-src {{APT-mirror|security}} {{Codename|stable}}{{#ifeq: {{Codename|stable}} | buster | /updates | -security }} main
 
{{Cautionbox | A partire da Debian 10 ([[Buster]]) è cambiata la sintassi per il mirror di sicurezza, che ora termina con '''debian-security'''. La forma precedente (senza ''debian-security'') '''non''' è più supportata.
 
Inoltre a partire da Debian 11 ([[Bullseye]]), si dovrà utilizzare ''codename'''''-security''' al posto di ''codename'''''/updates''', ossia nel caso di bullseye:
deb {{APT-mirror|security}} bullseye'''-security''' main}}
Ecco come invece si presenterà il file, se si sceglie di aggiungere anche "contrib" e "non-free" ai due repository precedenti:


Ecco come invece si presenta la riga se si sceglie di aggiungere le sezioni contenenti software non totalmente libero.<br>
deb {{APT-mirror}} {{Codename|stable}} main '''contrib non-free'''
solo contrib:
deb-src {{APT-mirror}} {{Codename|stable}} main '''contrib non-free'''
<pre>
deb http://ftp.it.debian.org/debian/ stable main contrib
# Sicurezza
deb-src http://ftp.it.debian.org/debian/ stable main contrib  
deb {{APT-mirror|security}} {{Codename|stable}}{{#ifeq: {{Codename|stable}} | buster | /updates | -security }} main '''contrib non-free'''
</pre>
deb-src {{APT-mirror|security}} {{Codename|stable}}{{#ifeq: {{Codename|stable}} | buster | /updates | -security }} main '''contrib non-free'''


anche non-free:
I repository sorgenti (''deb-src'') si possono anche rimuovere, se non si scaricano i sorgenti per controllarli o modificarli; oppure commentare (aggiungendo a inizio riga il carattere <code>#</code>), per poterli riabilitare facilmente.
<pre>
deb http://ftp.it.debian.org/debian/ stable main contrib non-free
deb-src http://ftp.it.debian.org/debian/ stable main contrib non-free
</pre>


Il repository di apt-build:
Di seguito il repository di <code>apt-build</code>, se si compilano i pacchetti sorgenti localmente:
<pre>
<pre>
deb file:/var/cache/apt-build/repository apt-build main
deb file:/var/cache/apt-build/repository apt-build main
</pre>
</pre>


Un repository 'artigianale' accessibile tramite un webserver:
E un esempio di repository 'artigianale', accessibile tramite un webserver:
<pre>
<pre>
deb http://repos.debianizzati.org ./
deb http://repos.debianizzati.org ./
</pre>
</pre>


Un repository situato nella home dell'utente maxer, creato con <code>dpkg-scanpackages</code>:
E per finire ecco invece un repository situato nella home dell'utente maxer, creato con <code>dpkg-scanpackages</code>:
<pre>
<pre>
deb file:/home/maxer/repos ./
deb file:/home/maxer/repos ./
Riga 95: Riga 168:
Per altri repository vedere: [[Repository ufficiali|Lista repository ufficiali Debian]] e [[Repository non ufficiali]].
Per altri repository vedere: [[Repository ufficiali|Lista repository ufficiali Debian]] e [[Repository non ufficiali]].


=== Sources.list aggiuntivi ===
==== Sources.list aggiuntivi ====
A volte può capitare di avere l'esigenza di avere più di un file contenente la lista dei repository da cui scaricare i pacchetti. Questo può capitare nel caso il file <code>sources.list</code> inizi a contenere un numero molto elevato di righe oppure perché si vogliono utilizzare dei repository diversi per le normali operazioni sui pacchetti.
A volte si può avere l'esigenza di disporre di più di un file per contenere la lista dei repository. Questo può capitare nel caso in cui il file <code>sources.list</code> inizi a contenere un numero molto elevato di righe oppure perché si vogliono utilizzare dei repository diversi per le normali operazioni sui pacchetti.


Per far ciò è possibile creare dei semplici file di testo, contenenti gli indirizzi dei repository, nella directory <code>/etc/apt/sources.list.d</code> . La sintassi da utilizzare al loro interno è uguale a quella del file <code>sources.list</code>; si può scegliere liberamente il nome da assegnare ai file purché termini con l'estensione <code>.list</code>
Per far ciò è possibile creare dei semplici file di testo, contenenti gli indirizzi dei repository, nella directory <code>/etc/apt/sources.list.d</code> . La sintassi da utilizzare al loro interno è uguale a quella del file <code>sources.list</code>; si può scegliere un qualunque nome (con caratteri alfabetici e numerici) da assegnare ai file purché termini con l'estensione <code>.list</code> .


Una volta creati i file aggiuntivi, questi verranno considerati da APT come se le righe al loro interno fossero presenti all'interno del file <code>sources.list</code>.
Una volta creati i file aggiuntivi, questi verranno considerati da APT come se le righe al loro interno fossero presenti nel file <code>sources.list</code> .


È possibile anche specificare un file, contenente gli indirizzi dei repository, che non si trova all'interno della directory <code>/etc/apt/sources.list.d</code>. Ad esempio, se il repository da cui abitualmente scarichiamo/aggiorniamo i pacchetti è irraggiungibile, basta creare un file (nell'esempio chiamato <code>nomefile.list</code>) contenente dei repository appartenenti ad un diverso mirror ed eseguire:
È possibile anche specificare un file, contenente gli indirizzi dei repository, che non si trova all'interno della directory <code>/etc/apt/sources.list.d</code>. Ad esempio, se il repository da cui abitualmente scarichiamo/aggiorniamo i pacchetti è irraggiungibile, basta creare un file (nell'esempio chiamato <code>nomefile.list</code>) contenente dei repository appartenenti ad un diverso mirror ed eseguire:
<pre># apt-get -o Dir::Etc::SourceList=/percorso/del/file/nomefile.list update
<pre># apt-get -o Dir::Etc::SourceList=/percorso/del/file/nomefile.list update
</pre>
</pre>
Bisogna specificare obbligatoriamente il percorso completo del file se questo non si trova nella directory <code>/etc/apt/sources.list.d</code>
Bisogna specificare obbligatoriamente il percorso completo del file se questo non si trova nella directory <code>/etc/apt/sources.list.d</code> .
 
== Pinning, ovvero come usare repository appartenenti a differenti relase ==
{{Box|NOTE| I paragrafi 5.1, 5.2, 5.3 e 5.4 sono una riproposizione della guida originale pubblicata su [http://www.mirkopagliai.it/debian-repository-e-pinning  www.mirkopagliai.it], distribuita secondo licenza originale CC.}}
 
=== Introduzione ===
 
Come molti sapranno, esistono tre versioni di Debian (chiamate anche release):
# Debian stable, attualmente ''Squeeze'';
# Debian testing, attualmente ''Wheezy'';
# Debian unstable, attualmente (e sempre,  un nome fisso) ''Sid''.
Il  software della stable non viene aggiornato, eccezion fatta per gli  aggiornamenti della sicurezza; il software della testing e della  unstable viene al contrario aggiornato frequentemente, con una maggiore  frequenza per la unstable. Oltre queste tre, ci sarebbero anche la  ''oldstable'' (la vecchia stable, precedente all’attuale stable) e la  ''experimental'' (una versione altamente sperimentale), ma di  scarsissima diffusione rispetto alle altre (e che vi sconsiglio  caldamente).
<br/>
Vi invito ad un approfondimento  dell’argomento (approfondimento che personalmente considero molto  interessante), sia sulle precise differenze tra le versioni, sia sui  meccanismi che portano al passaggio da una versione a un’altra².
<br/><br/>
Ora,  spesso accade che utilizzando la testing o ancor di più la stable si  voglia del software più nuovo rispetto a quello in dotazione; o che al  contrario, utilizzando la testing o ancor di più la unstable si voglia  del software più stabile rispetto a quello in dotazione. Qui entra in  gioco il pinning dei repository, o meglio “tra i repository”, che  permette di installare con semplicità del software appartenente a una  versione di Debian diversa da quella in uso o anche solo appartenente  alla stessa distribuzione, ma proveniente da un altro repository. Tutto  ciò eliminando il rischio di creare problemi nel sistema e nel gestore  dei pacchetti poiché non è detto che l'attribuzione di priorità  automatica dia il risultato voluto e/o migliore.
Il pinning  permette anche di scegliere se installare solo un pacchetto da un’altra  versione o anche le sue relative dipendenze (alternativamente, verranno  utilizzate le dipendenze della versione in uso, se disponibili).
Affinché  questo sia possibile, è necessario innanzitutto istruire apt secondo i  nostri desideri. I file in questione sono due e precisamente  ''/etc/apt/apt.conf'' e ''/etc/apt/preferences'', che ora andremo ad  analizzare. In un’installazione di default questi due file non sono  normalmente presenti (vengono utilizzate delle impostazioni di default),  quindi dovremmo procedere col crearli manualmente con i privilegi di  root.
 
=== Il file /etc/apt/apt.conf ===
<pre>
APT::Default-Release "testing";
APT::Cache-Limit 24000000;
Apt::Get::Purge;
APT::Clean-Installed;
APT::Get::Fix-Broken;
APT::Get::Fix-Missing;
APT::Get::Show-Upgraded "true";
APT::Force-LoopBreak=true;
APT::Get::AllowUnauthenticated 1;
</pre>
Andiamo ad analizzare questo esempio riga per riga:
# specifichiamo la versione di Debian predefinita, quella che vogliamo utilizzare di default (nel mio caso e negli esempi successivi la testing);
# specifichiamo la dimensione della cache;
# ordiniamo il purge dei pacchetti;
# ordiniamo la pulizia della cache;
# chiediamo di sistemare automaticamente i pacchetti che presentano dipendenze non soddisfatte;
# chiediamo di sistemare i pacchetti non possibili da installare;
# chiediamo di mostrare gli upgrade dei pacchetti;
# chiediamo di forzare il ''loop'' dei pacchetti con dipendenze non soddisfatte;
# autorizziamo l’installazione di pacchetti non autenticati.
Essendo  questo un argomento molto complesso, per scoprire tutte le funzioni  disponibili e per approfondire il funzionamento di quelle appena  elencate, vi rimando al manuale e agli help:
<pre>
# apt-get --help
# aptitude --help
man apt.conf
</pre>


=== Il file /etc/apt/preferences ===
==== Esempi di configurazioni consigliate ====
Nel  file preferences è possibile definire la priorità delle varie versioni  dei pacchetti tramite un sistema basato sui pin. Vediamo quindi i  possibili valori dei pin, avendo cura di ricordare che con "target  relase" si intende quella specificata alla  riga  <code>APT::Default-Release</code> del file   <code>apt.conf</code> (quindi testing nel caso del  precedente esempio).
===== Stable più aggiornata =====
* pin maggiore di 1000: il pacchetto ha  l’assoluta priorità nell’installazione, anche nel caso cioè che sia  disponibile una versione dello stesso nel repository della "target  relase" e persino se l'eventuale versione già installata è più recente  (quindi è possibile anche un downgrade);
Per avere una Debian [[stable]] completamente libera, di seguito si propone una configurazione del file <code>/etc/apt/sources.list</code> con soli repository ufficiali, utilizzando il [[mirror]] {{APT-mirror|descrizione}} e abilitando aggiornamenti raccomandati e [[backports]]:
* pin compreso tra 991 e  1000: il pacchetto viene installato anche nel caso sia disponibile una  versione dello stesso nel repository della "target relase", ma NON se  nel sistema è già presente una versione più recente;
* pin  compreso tra 501 e 990: il pacchetto sarà installato solo se questo non è  presente nella "target relase" e/o se la versione eventualmente già  installata non è più recente;
* pin compreso tra 101 e 500: il  pacchetto sarà installato solo se questo non è presente nella "target  relase" e/o in altri repository e/o se la versione eventualmente già  installata non è più recente;
* pin compreso tra 0 e 100: il pacchetto viene installato solo se non è installata nessuna versione del pacchetto;
* pin minore di 0 (negativo): l’installazione del pacchetto è impedita a priori (salvo apposito comando), qualsiasi sia l’origine.
Ecco un esempio del file preferences:
<pre>
Package: *
Pin: release a=testing
Pin-Priority: 900
Package: *
Pin: release o=Debian
Pin-Priority: -10
</pre>
Questo esempio tiene conto di due casi:
# i pacchetti della testing, cui viene assegnato pin 900 (dalla riga 1 alla 3);
# tutti gli altri pacchetti di tutte le altre versioni (in questo caso quindi di stable e unstable), cui viene assegnato pin -10 (dalla riga 5 alla 7).
In altri termini, qui abbiamo specificato che i pacchetti  della testing (che è anche la versione indicata in apt.conf) dovranno  avere la massima priorità. Ai pacchetti di altre versioni non è  assegnata nessuna priorità (pin minore di 0) e quindi verranno  eventualmente installati solo su nostro comando.<br>
Per una guida esaustiva <code>man apt_preferences</code>.


=== Installare tramite pinning ===
# Repository principale
Fatto questo, sarà sufficiente aggiungere al proprio ''/etc/apt/sources.list'' i repository delle altre versioni che ci  interessano.
  deb {{APT-mirror}} {{Codename|stable}} main
Per installare pacchetti dalla nostra versione in uso, quella che abbiamo anche specificato in ''apt.conf'', procederemo  normalmente, come abbiamo sempre fatto. Per pacchetti di altre versioni, invece, avremo a disposizione due comandi:
  deb-src {{APT-mirror}} {{Codename|stable}} main
<pre>
 
# apt-get install pacchetto/unstable
  # Aggiornamenti di sicurezza
</pre>
  deb {{APT-mirror|security}} {{Codename|stable}}{{#ifeq: {{Codename|stable}} | buster | /updates | -security }} main
che installa ''pacchetto'' dalla ''unstable'' con le dipendenze della versione indicata in ''/etc/apt/apt.conf'' (nell’esempio vista prima, la testing), se disponibili. In alternativa:
deb-src {{APT-mirror|security}} {{Codename|stable}}{{#ifeq: {{Codename|stable}} | buster | /updates | -security }} main
<pre>
 
# apt-get install -t unstable pacchetto
  # Aggiornamenti raccomandati (ex-volatile)
</pre>
  deb {{APT-mirror}} {{Codename|stable}}-updates main
che installa ''pacchetto'' dalla ''unstable'' con le dipendenze della ''unstable''.
  deb-src {{APT-mirror}} {{Codename|stable}}-updates main
 
# Backports
deb {{APT-mirror}} {{Codename|stable}}-backports main
deb-src {{APT-mirror}} {{Codename|stable}}-backports main


=== Un esempio concreto ===
Si avrà sempre la versione più aggiornata disponibile di un pacchetto presente in uno di questi repository, a eccezione dei ''backports''. Per maggiori informazioni e istruzioni su come installare un pacchetto dai ''backports'' si rimanda a [[Il repository Backports#Utilizzo | questa sezione]] della loro guida.<br/>
In particolare per un sistema di produzione va considerato che i ''backports'' non sono sottoposti agli stessi controlli degli altri repository.


In  questo how-to mostrerò come utilizzare pacchetti Debian provenienti da  Testing, Unstable, Experimental, Marillat (multimedia/video) e  Rarewares.org (multimedia/audio), ma le istruzioni sono facilmente  riportabili anche ad altre situazioni (unstable + experimental, stable +  testing, stable + unstable, stable + testing + unstable, ecc...).
I repository dei sorgenti sono abilitati, come di default, ma se non si è interessati si possono commentare con <code>#</code> le righe inizianti con <code>deb-src</code>.


==== Impostare i repository ====
Come già visto in precedenza, per aggiungere software non libero è necessario abilitare una o entrambe le sezioni [[contrib]] e [[non-free]] per ogni repository. Per esempio per abilitarle entrambe il primo repository diverrebbe:
deb {{APT-mirror}} {{Codename|stable}} main '''contrib non-free'''


Assicuriamoci di essere l'utente root e procediamo.
===== Stable (come di default), Testing o Unstable =====
Leggere la guida: [[Repository ufficiali]]


Per  prima cosa editiamo il file  <code>/etc/apt/sources.list</code> ed inseriamo gli archivi  dei pacchetti Debian che utilizzeremo, per esempio:
===== Experimental =====
<pre>
Si legga attentamente la sezione: [[Repository speciali#Debian_experimental | Debian experimental]] (repository speciali)
### Debian Ufficiale -- Testing
deb http://ftp.it.debian.org/debian/ testing main non-free contrib


### Debian Ufficiale -- Testing Sicurezza
E si ricordi, non essendo autosufficienti, di utilizzare i repository di Debian '''unstable'''/'''Sid''' (reperibili [[Repository ufficiali#Unstable: Debian Sid|qui]]).
deb http://security.debian.org/ testing/updates main contrib non-free


### Debian Ufficiale -- Sid
=== Altre modifiche ai repository ===
deb http://ftp.it.debian.org/debian/ unstable main non-free contrib
==== Utilizzare la suite (o archive) ====
Se si preferisce indicare una [[release]] con il nome della [[suite]] (''stable'') invece del [[codename]] (''{{Codename|stable}}''), si noti che in questo momento le due righe:


### Debian Ufficiale -- Experimental
  deb {{APT-mirror}} '''stable''' main
deb http://ftp.debian.org/debian/ ../project/experimental main


### Multimedia -- Audio -- Rarewares
deb {{APT-mirror}} '''{{Codename|stable}}''' main
deb http://www.rarewares.org/debian/packages/unstable ./


### Multimedia -- Video -- Marillat
sono equivalenti come le equivalenti sostituzioni per le righe relative a tutti gli altri repository.<br/>
deb ftp://ftp.nerim.net/debian-marillat/ etch main
Allo stesso modo sono equivalenti:
deb ftp://ftp.nerim.net/debian-marillat/ sid main
</pre>


==== Configurare apt ====
deb {{APT-mirror}} '''testing''' main


A questo punto dobbiamo preparare due file normalmente non presenti sulla nostra debianbox: si tratta dei file <code>/etc/apt/preferences</code> e <code>/etc/apt/apt.conf</code>.
  deb {{APT-mirror}} '''{{Codename|testing}}''' main
Questi due file istruiranno APT su come gestire le dipendenze dei pacchetti,  informandolo su come comportarsi in caso di conflitti e altri problemi.


Prestare particolare attenzione al fatto che questa equivalenza non sarà più valida al momento del rilascio della nuova [[stable]].<br/>
Vedere anche [[La struttura della Distribuzione]].


===== Il file <code>preferences</code> =====
Si noti che utilizzare il [[codename]] è la pratica raccomandata, in quanto impedisce l'aggiornamento automatico a una nuova release, il che è utile se:
* si vuole prima leggere attentamente le [https://www.debian.org/releases/stable/releasenotes.it.html note di rilascio] della nuova stable, in modo da seguire la procedura raccomandata per l'aggiornamento;
* si preferisce rimandare il passaggio di versione a un'altra data, senza rinunciare per questo a ricevere gli aggiornamenti di sicurezza, che sono garantiti per circa un anno dal momento del rilascio della nuova stable;
* si vuole continuare a usare la versione precedente (considerata [[oldstable]]), avvalendosi al momento della scadenza del supporto ufficiale di quello [[LTS]] (a lungo termine), che ne estende la durata di altri due anni per i pacchetti più importanti e le principali architetture;
* si preferisce installare da zero una Debian pulita, anziché aggiornare.


Creiamo il file <code>/etc/apt/preferences</code>:
==== Passaggio di versione alla nuova stable ====
<pre>
Dal giorno in cui è rilasciata la nuova versione stabile di Debian, tutti coloro che nel proprio file <code>/etc/apt/sources.list</code> utilizzano il termine "stable":
# touch /etc/apt/preferences
...
</pre>
deb {{APT-mirror}} '''stable''' main
editiamolo col nostro editor di fiducia e inseriamo queste direttive:
...
<pre>
continueranno a ricevere aggiornamenti dai repository "stable", che però faranno riferimento alla nuova versione.
Package: *
Pin: release o=Unofficial Multimedia Packages
Pin-Priority: 950


Package: *
Coloro che invece, come raccomandato, utilizzano il [[codename]]:
Pin: release o=xmixahlx
...
Pin-Priority: 900
deb {{APT-mirror}} '''{{Codename|oldstable}}''' main
...
quando desiderano effettuare il passaggio di versione a Debian {{Codename|versione_stable}} ([[{{Codename|Stable}}]]), e dopo aver letto le [https://www.debian.org/releases/stable/releasenotes.it.html note di rilascio], dovranno sostituire in tutte le righe del file <code>sources.list</code> il termine "{{Codename|oldstable}}" con "{{Codename|stable}}" (il codename per la nuova stable). Senza questa modifica continueranno a ricevere aggiornamenti per un periodo di tempo limitato (di circa un anno) per consentire aggiornamenti alla [[oldstable]].


Package: *
==== Passaggio da stable a testing ====
Pin: release a=testing
È necessario modificare tutte le occorrenze di "stable" (o "{{Codename|stable}}") con "testing" (o "{{Codename|testing}}") all'interno del file <code>/etc/apt/sources.list</code> e poi aggiornare la lista dei pacchetti.<br/>
Pin-Priority: 850
Per la ''testing'' non esistono i repository "updates", "proposed-updates" e backports.


Package: *
==== Passaggio da testing a unstable ====
Pin: release a=unstable
Leggere la guida [[Installare Debian SID]]
Pin-Priority: 800


Package: *
== Mirrors ==
Pin: release a=experimental
<!--
Pin-Priority: 750
  NOTA: *NON* cambiare il nome della sezione "Mirrors", perché è utilizzata da altre guide
</pre>
-->
I repository ufficiali sono resi disponibili attraverso molteplici fonti, ovvero oltre al classico <code>{{APT-mirror|it}}</code> esistono numerosi altri repository secondari che è possibile usare in maniera sicura. Scegliere di usare una "copia" dei repository invece dei primari garantisce due vantaggi:
* la velocità di scaricamento dei pacchetti solitamente aumenta;
* si alleggerisce il carico di lavoro cui sono soggetti i repository primari.


Il pinning può essere orientato ad un archivio, un'origine, la versione di un pacchetto, un componente, ecc...
=== Scelta del mirror più veloce ===
 
Lo strumento <code>netselect-apt</code> permette di condurre in maniera automatica un test di velocità su tutti i repository primari e secondari ad esso noti e quindi di selezionare il mirror più veloce.
Con '''"o="''' si specifica l' origine (la distribuzione) del pacchetto, con '''"a="''' l'archivio (sarge, sid, stable, ecc...).
 
Questo  dato è reperibile in modo inequivocabile attraverso APT, andando a  sbirciare all'interno del file "Release" che è contenuto in tutti i   repository ufficiali. Per archivi personali e/o non ufficiali, invece,  non è sempre e necessariamente presente (purtroppo).
 
Vediamo alcuni esempi:


Per l'installazione è sufficiente digitare:
<pre>
<pre>
# cd /var/lib/apt/lists
# apt install netselect-apt
# cat www.rarewares.org_debian_packages_unstable_._Release
Archive: unstable
Origin: xmixahlx                    
Label: xmixahlx_rarewares-unstable
Architecture: i386
 
# cat ftp.nerim.net_debian-marillat_dists_testing_main_binary-i386_Release
Archive: testing
Component: main
Origin: Unofficial Multimedia Packages
Label: Unofficial Multimedia Packages
Architecture: i386
</pre>
</pre>


Dove:
Per l'utilizzo invece basta semplicemente scrivere:
* '''Archive''' = è l'archivio Debian a cui i pacchetti appartengono (ad es.: stable, testing. ecc...);
* '''Component''' = indica il tipo di componente (ad es.: main, contrib, non-free);
* '''Origin''' = specifica il proprietario del repository;
* '''Label''' = identifica il repository: potete inserire descrizioni, ecc...;
* '''Architecture''' = l'architettura dei pacchetti contenuti nel repository (ad es.: i386, sparc, source, ecc...).
 
Possiamo vedere che nel file Release è contenuto proprio il dato che stavamo cercando: Origin.
 
 
===== Il file <code>apt.conf</code> =====
 
Ora creiamo il file <code>/etc/apt/apt-conf</code>
 
<pre>
# touch /etc/apt/apt.conf
</pre>
 
editiamolo inserendo quanto segue:
 
<pre>
<pre>
APT::Default-Release "testing";
# netselect-apt
APT::Cache-Limit 15000000;
Apt::Get::Purge;
APT::Clean-Installed;
APT::Get::Fix-Broken;
APT::Get::Fix-Missing;
APT::Get::Show-Upgraded "true";
</pre>
</pre>


Facciamo l'update del database dei pacchetti:
Al termine della procedura (meno di cinque minuti) lo strumento proporrà un elenco composto dai dieci mirror secondo lui più veloci e quindi l'utente, se lo desidera, potrà decidere di modificare il proprio file <code>sources.list</code> sostituendo il repository primario con quello secondario suggerito.


<pre>
=== Uso di HTTP Redirector ===
# apt-get update
{{#ifeq: {{APT-mirror|descrizione}} | HTTP redirector | È la scelta di default a partire da Debian 10 ([[Buster]]), e risolve il problema di dover scegliere un mirror.<br/> | Risolve il problema di dover scegliere un mirror.}}
</pre>
Usando dei dati come la posizione geografica della connessione dell'utente, la famiglia di indirizzi IP, la disponibilità e l'aggiornamento dei mirror, l'architettura dei pacchetti da scaricare e altre cose, il ''redirector'' riesce a fornire all'utente in modo trasparente il miglior mirror per un dato pacchetto. Tra i molti vantaggi rispetto ad un mirror tradizionale si annoverano una velocità maggiore di scaricamento (grazie ai download in parallelo da più mirror) e il non dover aggiornare il <code>sources.list</code> con un nuovo mirror in caso di viaggi o spostamenti.


D'ora in avanti avremo due possibilità per installare un nuovo pacchetto: il metodo che usiamo di solito e cioè:
È sufficiente utilizzare '''<code>{{APT-mirror|redirector}}</code>''' come mirror al posto di quello usato nel proprio <code>/etc/apt/sources.list</code> per tutti i repository aggiunti, meno quello di sicurezza (che è consigliato lasciare <code>{{APT-mirror|security}}</code>).


<pre>
Per maggiori informazioni si può consultare il [http://deb.debian.org/ sito ufficiale].
# apt-get install nome_pacchetto
</pre>
 
che utilizzerà pacchetti proveniente dalla versione impostata come '''Default-Release''' in '''apt.conf''', oppure il comando
 
<pre>
# apt-get install -t versione_di_debian nome_pacchetto
</pre>


che  provvederà a installare il pacchetto da noi richiesto per la versione  specificata (versione_debian), risolvendo automaticamente le dipendenze.
== Approfondimenti ==
==== Manpages ====
<code>man sources.list</code>


----
{{Autori
{{Box|NOTE|
|Autore = [[Utente:MaXeR|MaXeR]]
Autori:
|Estesa_da =
* [[Utente:MaXeR|MaXeR]]
: [[Utente:Keltik|keltik]]
* [[Utente:Keltik|keltik]]
: [[User:Nest|Nest]]
Esteso da:
: [[Utente:Ernestus|Ernestus]]
* [[User:Nest|Nest]]
: [[Utente:HAL 9000|HAL 9000]]
* [[Utente:Ernestus|Ernestus]]
: [[Utente:S3v|S3v]]
Verificato da:
: [[Utente:Wtf|Wtf]]
* [[Utente:TheNoise|~ The Noise]]
: [[Utente:BubuXP|BubuXP]]
* [[Utente:Risca86|Risca]]
|Verificata_da =
: [[Utente:TheNoise|~ The Noise]]
: [[Utente:Risca86|Risca]]
: [[Utente:Wtf|Wtf]]
: [[Utente:Marcomg|Marcomg]]
: [[Utente:S3v|S3v]] 13:28, 30 ago 2014 (CEST)
: [[Utente:HAL 9000|HAL 9000]] 15:26, 3 ago 2019 (CEST)
|Numero_revisori = 6
}}
}}


[[Categoria:Repository ufficiali]][[Categoria:Apt]]
[[Categoria:Repository ufficiali]][[Categoria:Apt]]
3 581

contributi