Quentin Debhi has proposed merging
~ruinedyourlife/lp-archive:feat-copy-docs-and-changes into lp-archive:main.
Commit message:
Support copy-docs, new section for all repositories and small changes
Addressing the comments Aaron has made, adding support for copy-docs, creating
a new section detailing how to use a specific snapshot for all repositories
that support it and small changes
Requested reviews:
Launchpad code reviewers (launchpad-reviewers)
For more details, see:
https://code.launchpad.net/~ruinedyourlife/lp-archive/+git/lp-archive/+merge/465046
--
Your team Launchpad code reviewers is requested to review the proposed merge of
~ruinedyourlife/lp-archive:feat-copy-docs-and-changes into lp-archive:main.
diff --git a/lp_archive/templates/index.html b/lp_archive/templates/index.html
index 07aaf55..1eb5914 100644
--- a/lp_archive/templates/index.html
+++ b/lp_archive/templates/index.html
@@ -3,6 +3,7 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="copydoc" content="https://docs.google.com/document/d/1loqLRYCZ1CmvK5iVIRunTC947XjlRHkUMnUHGndwqtg";>
<title>Ubuntu Snapshot Service</title>
<link rel="stylesheet" href="https://assets.ubuntu.com/v1/vanilla-framework-version-4.9.1.min.css"; />
</head>
@@ -41,7 +42,7 @@ amd64 hello amd64 2.10-3 [26.2 kB]</code></pre>
<div class="row">
<div class="col-12">
<h2>How to Use Snapshots on Ubuntu</h2>
- <h3 class="u-sv3">Enable Snapshot Service</h3>
+ <h3 id="enable-snapshot-service" class="u-sv3">Enable snapshot service on configured repositories</h3>
<h4>For Ubuntu 24.04 and later</h4>
<p>The <code>apt</code> included in Ubuntu 24.04 and later automatically detects when snapshots are supported for a repository (any repository with a Snapshots: directive in the Release file). This includes the official Ubuntu repositories, so snapshots for these will be enabled by default.</p>
@@ -62,8 +63,8 @@ apt policy hello -S 20231102T030400Z
apt install hello --snapshot 20231102T030400Z</code></pre>
<p>Note that the <code>apt update --snapshot [snapshot]</code> command needs to be run immediately before the other <code>apt</code> commands. These commands will also fail if the snapshot format is incorrect or the snapshot does not exist (for example, if you try to use a date before that Ubuntu release existed).</p>
- <h4>Using a specific Snapshot ID for all apt commands</h4>
- <p>Enabling snapshots for the repository will allow you to specify a snapshot when using <code>apt</code>, as shown above. Alternatively, it is possible to set <code>apt</code> to use a particular snapshot for all <code>apt</code> commands. To do this, the specific Snapshot ID (e.g. 20230302T030400Z) can be used in the place of “yes” in the relevant source. If a specific snapshot is configured in this way then it will be used even if a different snapshot ID is given as part of an <code>apt</code> command.</p>
+ <h4>Using a specific snapshot for a repository for all apt commands</h4>
+ <p>Enabling snapshots for the repository will allow you to specify a snapshot when using <code>apt</code>, as shown above. Alternatively, it is possible to set <code>apt</code> to use a particular snapshot for all <code>apt</code> commands for a repository, including <code>unattended-upgrades</code>. To do this, the specific Snapshot ID (e.g. 20230302T030400Z) can be used in the place of “yes” in the relevant source. If a specific snapshot is configured in this way then it will be used even if a different snapshot ID is given as part of an <code>apt</code> command.</p>
<p>For example, on Ubuntu 24.04 LTS onwards:</p>
<pre><code>Types: deb
URIs: http://archive.ubuntu.com/ubuntu
@@ -84,8 +85,14 @@ Snapshot: 20240301T030400Z</code></pre>
<pre><code>deb [snapshot=20230302T030400Z] http://archive.ubuntu.com/ubuntu/ jammy main restricted
deb [snapshot=20230302T030400Z] http://archive.ubuntu.com/ubuntu/ jammy-updates main restricted
deb [snapshot=20230302T030400Z] http://security.ubuntu.com/ubuntu jammy-security main restricted</code></pre>
+
+ <h4>Using a specific snapshot for all repositories that support snapshots</h4>
+ <p>Alternatively, across all supported Ubuntu releases, a snapshot can be set for all repositories that have snapshots enabled on a system using an <code>pt.conf</code>a variable. First, ensure the <a href="#enable-snapshot-service">relevant repositories are enabled</a>, and then set <code>APT::Snapshot</code> to the relevant snapshot ID, for example:</p>
+ <pre><code>echo 'APT::Snapshot "20240301T030400Z";' | sudo tee
+/etc/apt/apt.conf.d/50snapshot</code></pre>
+ <p>As above, this snapshot will then be used for all <code>apt</code> commands, including <code>unattended-upgrades</code>. The system can then be updated to use a different snapshot by simply running the above command again with a different snapshot ID.</p>
- <h3>Disable Snapshot Service for a repository</h3>
+ <h3 class="u-sv3">Disable Snapshot Service for a repository</h3>
<h4>For Ubuntu 24.04 and later (Deb822 sources)</h4>
<p>As mentioned above, on Ubuntu 24.04 and later, snapshots are enabled automatically for supported repositories. If you do <b>not</b> want archive snapshots to be enabled for a repository, edit the relevant sources file (e.g. <code>/etc/apt/sources.list.d/ubuntu.sources</code>) to add <code>Snapshot: no</code> to the relevant sources, for example:</p>
<pre><code>Types: deb
_______________________________________________
Mailing list: https://launchpad.net/~launchpad-reviewers
Post to : launchpad-reviewers@lists.launchpad.net
Unsubscribe : https://launchpad.net/~launchpad-reviewers
More help : https://help.launchpad.net/ListHelp
