Commit Graph

42 Commits

Author SHA1 Message Date
Andrew Kester 891837abf9 Add `lsb-release` to required debian and ubuntu packages
Certain installations may not have this.  Without this, the step
where `/etc/apt/sources.list.d/docker.list` will fail and write
garbled data to the file, potentially breaking apt.

Co-Authored-By: Andrew Kester <akester@cox.net>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-09 15:47:10 +01:00
Sebastiaan van Stijn 2a84b75739
engine/install: uninstall: add removing containerd state to all distros
This was only included in some distributions, so adding it to all
pages.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-02 15:02:23 +01:00
Sebastiaan van Stijn d95a4266ff
replace "output truncated" with special <...> (supported by "rouge")
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-02 15:02:21 +01:00
Sebastiaan van Stijn f4ba73ecbb
engine/instal: use "console" code-hints for examples
This tones down the prompt and command output, so that the commands
to run stand out more clearly.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-02 15:02:12 +01:00
Sebastiaan van Stijn 687b46db9e
engine: add missing sudo in ubuntu instructions
Looks like the Debian version was updated during review, but the Ubuntu variant
was forgotten in 760bb64ea3

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-02 11:57:51 +01:00
denis-roy 760bb64ea3
Offering an alternative to the deprecated apt-key tool (#11990)
* Offering an alternative to apt-key (deprecated)

[Use trusted.gpg.d instead of apt-key · Issue #11625 · docker/docker.github.io](https://github.com/docker/docker.github.io/issues/11625)

As of Debian 10 / Ubuntu 20.10, apt-key is deprecated and will not be available after Debian 11 / Ubuntu 22.04

Although adding keys directly to `/etc/apt/trusted.gpg.d`/ is suggested by apt-key deprecation message, as per [Debian Wiki](https://wiki.debian.org/DebianRepository/UseThirdParty) GPG keys for third party repositories should be added to `/usr/share/keyrings` and referenced with the `signed-by` option in the source.list.d entry.

Providing a binary .gpg key instead of an ASCII Armored one might help shorten the lengthy command by removing the ` | gpg --dearmor ` bit.

This removes the software-properties-common provides add-apt-repository which we don't use anymore
2021-03-02 11:30:37 +01:00
Akihiro Suda 690e0010aa
update rootless docs
= _includes/install-script.md, engine/install/linux-postinstall.md =
- Remove "Rootless mode is currently available as an experimental feature."
  Close issue 12050

= engine/security/rootless.md =
== "Prerequiresites" section ==
- Remove information about old distros (Debian 9, CentOS 7.5-7.6)

== "Distribution-specific hint" section ==
- Tabified (`<div class="tab-content" />`)

== "Known limitations" section ==
- Kernel 5.11 supports rootless overlayfs, without the Ubuntu/Debian patch.

== "Install" section ==
- Promote RPM/DEB installation over TGZ installation.
  See docker/roadmap issue 188

== "Uninstall" section ==
- Add "Uninstall" section.
  Close issue 12053

== "Usage" section ==
- Added more information about systemd
- Move `nsenter` tips to "Tips for debugging" subsection under "Troubleshooting" section

== "Best practice" section ==
- Remove guide for `lxc-user-nic` network driver due to immaturity.
  Will be brought back in future.
  See rootless-containers/rootlesskit issue 138 .

== "Troubleshooting" section ==
- Add a guide for "can't open lock file /run/xtables.lock: Permission denied" (SELinux).
  See moby/moby issue 41230

- Add a guide for "failed to register layer: ApplyLayer exit status 1 ..." (NFS).
  Close docker/for-linux issue 1172

- Improve guides for slirp4netns.

- Remove v19.03 information (e.g., "cgroup v2 is unsupported, use cgroup v1")

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-02-12 19:36:51 +09:00
Akihiro Suda 6fec6ef0c3
engine/security: add more description about ssh://
Previously, the `ssh://` helper was only mentioned in `engine/security/index.md`.

The `ssh://` helper is now documented in "Protect the Docker daemon socket"
(`engine/security/protect-access.md`, nee `engine/security/https.md`).

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-02-10 19:06:09 +09:00
Sebastiaan van Stijn 6b1bae466f
engine: remove "upstart" section from post-install, and minor touch-ups
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-01-20 15:43:16 +01:00
Sebastiaan van Stijn ff16f50572
Rewrite logging section for dual logging (engine 20.10)
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-01-20 15:43:10 +01:00
Sebastiaan van Stijn be718ce241
Engine: update distro versions
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-12-09 01:13:35 +01:00
Sebastiaan van Stijn 05f9d31264
Merge pull request #11644 from rafauke/patch-1
docs: update supported Fedora versions
2020-12-09 01:09:42 +01:00
Akihiro Suda 1976c2178c
v20.10 docs for cgroup v2 and rootless
* Docker now supports cgroup v2 (both rootful and rootless)
* Rootless mode graduated from experimental
* New storage driver: fuse-overlayfs

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2020-11-12 12:47:16 +09:00
Rafał Wyszomirski 8561258256
docs: update supported Fedora versions 2020-10-27 18:25:50 +01:00
Usha Mandya cb4a1293a7
Merge pull request #11620 from thaJeztah/old_engines
Remove references to obsolete engine versions
2020-10-26 14:49:51 +00:00
Sebastiaan van Stijn 2ce808edc0
Remove references to obsolete engine versions
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-10-26 15:45:07 +01:00
Sebastiaan van Stijn b952763986
engine: add platform headings to TOC
This allows deep-linking to specific sections. Also fixed the checks
in the support table to be left-aligned as they were supposed to be.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-10-26 15:05:37 +01:00
Sebastiaan van Stijn c119ed174e
Use https:// for links and examples
Found these using `http://[^lp10\*`<][^o]` (to exclude "localhost" and IP-addresses)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-10-13 12:09:11 +02:00
Sebastiaan van Stijn 393d3f6566
Add rel="noopener" to external links
See https://web.dev/external-anchors-use-rel-noopener/

Using noopener, as that addresses the security issue. "noreferer" blocks
the REFERER header, which may still be useful for some target URLs.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-10-12 13:09:30 +02:00
John Visosky f67ae93112
Update ubuntu.md (#11299)
* Update ubuntu.md

After doing the 'apt-get rmove', I had to search to determine whether it was safe to remove /var/lib/docker, then found at the bottom of the page that it's OK to do so (if you don't have anything there you need).

Co-authored-by: Sebastiaan van Stijn <github@gone.nl>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2020-10-01 02:27:36 +02:00
Sebastiaan van Stijn 3823de5c50
engine/security: move landing page
Generated yaml files were temporarily updated manually (pending
pull request to be merged in the upstream docker/cli repository)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-09-29 21:27:08 +02:00
Usha Mandya bacb930cdc Add a new redirect for binaries
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2020-09-16 16:47:50 +01:00
Joshua Powers 8058df4f7e
Update ubuntu.md
Ubuntu 19.10 (Eoan) is EOL.
2020-08-10 11:16:12 -07:00
Usha Mandya b39a6c26d6
Merge pull request #11020 from ProgramComputer/patch-1
Update debian.md
2020-07-29 14:07:47 +01:00
Sebastiaan van Stijn 2b4833a355
Remove some references to enterprise products
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-07-02 23:36:48 +02:00
Paul 3b57ab426c
Update debian.md
containerd package still in library
2020-06-20 20:59:43 -05:00
Sebastiaan van Stijn 3e767a72b3
Update architectures in matrix (#10999)
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-06-16 14:39:07 +01:00
Amal 12b8e799c7
Typo fixture (#10950)
* Typo fixture

* Minor typo fix

* Typo fix
2020-06-03 19:21:11 +01:00
Sebastiaan van Stijn a25fa2949e
Engine: add Ubuntu 20.04 (Focal) to list of versions (#10944)
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-06-02 14:55:31 +01:00
Sebastiaan van Stijn 48040f57be
Update naming for "Linux Mint", and add note about derivatives (#10696)
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-24 13:41:06 +01:00
Ivan Cheban a494195c46
Typo: form should be from (#10685) 2020-04-24 09:01:12 +01:00
Sebastiaan van Stijn 777c5d23da
engine: use relative markdown links
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-23 13:03:32 +02:00
Sebastiaan van Stijn 9f5130c83b
engine/install: fix rasbian links on "check" icons
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-21 12:13:08 +02:00
Usha Mandya 9d865ebcb9
Merge pull request #10623 from m-aXimilian/patch-1
Update debian.md
2020-04-14 14:07:55 +00:00
Sebastiaan van Stijn 9b74d86033
remove unused images
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-12 22:35:10 +02:00
m-aXimilian 22428abcc5
Update debian.md
Changed "Ubuntu" to "Debian"
2020-04-12 14:22:39 +02:00
Cristian Souza 2507efa466
Removal of a duplicate command
Removal of a duplicate command from the Fedora installation guidelines.
2020-04-10 19:30:15 -03:00
Matt B 0fb13b05fc fixed typo, the markdown was collapsing spaces. Changed to explicitly preserve the two spaces by including html span, code tag and two &nbsp characters; 2020-04-06 19:16:50 -07:00
Sebastiaan van Stijn b814ef74da
engine: fix ubuntu SEO redirect
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-06 19:30:47 +02:00
Sebastiaan van Stijn 569f448ac7
engine: cleanup install page, add info about derivatives
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-06 14:04:27 +02:00
Sebastiaan van Stijn d5207b0580
engine: remove overlap between "overview" and "install" page
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-06 14:04:20 +02:00
Sebastiaan van Stijn d813acb6e1
Engine: reorganize install topic
- Move getting started overview to /get-started/overview/
- Move engine installation files under /engine/
- Redirect the top-level /install/ to /get-docker/
- Updated titles in left-hand navigation
- Added back some pages to the navigation that were
  currently not included.
- Reduce some steps in the installation pages
- Move devicemapper prerequisites to the devicemapper
  storage driver page.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-06 10:50:28 +02:00