Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Broken links #1068

Closed
aduermael opened this issue Jan 9, 2017 · 46 comments · Fixed by #1363
Closed

Broken links #1068

aduermael opened this issue Jan 9, 2017 · 46 comments · Fixed by #1363

Comments

@aduermael
Copy link
Contributor

aduermael commented Jan 9, 2017

Problem description

I have a pending PR ( #1052 ) to check all links to local resources. But now I need all broken links to be fixed in order to merge it. There are a lot, and in many cases, I personally don't know how to fix them.

Can we please divide it up and get this done as soon as possible?

Thank you!

html_test.go:55: /allpagelinks/index.html
	broken: <a href="404.md">
html_test.go:55: /apidocs/overview/index.html
	broken: <a href="apidocs/overview.md" class="button darkblue-btn nomunge" style="color:#FFFFFF; width:100%; margin: 0px;">

EDIT

#1052 has been merged. But then changes for 1.13 have been merged, without running the tests. So we now have new broken links. I listed them in that spreadsheet

@aduermael
Copy link
Contributor Author

cc @johndmulhausen

@sanscontext
Copy link
Contributor

For the Docker Cloud API docs ones, if you navigate to the page it works:

https://docs.docker.com/apidocs/docker-cloud/#service goes to https://docs.docker.com/docker-cloud/apps/service-scaling/ which is a valid page

I think that what’s going on is the link checker is looking at files that are generated by the build, but not actually linked anywhere. I believe the make release build process there builds a “single page” layout, and then a series of one-pagers per topic, but AFAICT we don't actually use the single-pagers anywhere. They're broken because it generates them into a subfolder, but from the same source files as those that generate the working ones (and which don't trigger the link checker).

joaofnfernandes pushed a commit to joaofnfernandes/docker.github.io that referenced this issue Jan 9, 2017
@aduermael
Copy link
Contributor Author

Thanks @joaofnfernandes for your commit!
I updated the list (~15% of it has been fixed)

@aduermael
Copy link
Contributor Author

@sanscontext i don't understand your comment.
Can you point me to specific lines that shouldn't appear?

@aduermael
Copy link
Contributor Author

@sanscontext I fixed links in /apidocs/docker-cloud/includes: #1087 (waiting for CI to pass)

@sanscontext
Copy link
Contributor

@aduermael Those files are programmatically generated. Did you fix them and see if running make release in that dir clobbers your changes?

@sanscontext
Copy link
Contributor

@aduermael
Copy link
Contributor Author

@sanscontext oh no, I didn't... :( I'll try.

@aduermael
Copy link
Contributor Author

@sanscontext But shouldn't that be triggered in the Dockerfile?

@sanscontext
Copy link
Contributor

@aduermael These were migrated wholesale from the original cloud-docs repo (which I didn't set up, my understanding is that was migrated from an earlier tutum repo), and the docs change so infrequently it hasn't been worth it. (It's also nice to be able to run make release and preview the Slate generated docs before you commit.)

@aduermael
Copy link
Contributor Author

@sanscontext Ok, so can I fix content directly in apidocs/cloud-api-source? Or do we keep pulling that from elsewhere?

@sanscontext
Copy link
Contributor

(We had a long offline conversation about this, thanks for your patience. :) ) Yup, as long as you update it in the source, it'll build the fix each time.

@aduermael
Copy link
Contributor Author

@sanscontext thanks for your patience too! :) And thanks for merging #1087.
I rebased #1052 and updated the failing test logs in that issue, it's getting better!

sanscontext pushed a commit to sanscontext/docker.github.io that referenced this issue Jan 11, 2017
Signed-off-by: LRubin <lrubin@docker.com>
@sanscontext
Copy link
Contributor

I just pushed a PR for Hub and Cloud fixes. FWIW, what you're using as a validator isn't picking up our "redirects". (Which explains how we've had so many "broken" links that are still "working". 🤔 )

sanscontext pushed a commit to sanscontext/docker.github.io that referenced this issue Jan 11, 2017
Signed-off-by: LRubin <lrubin@docker.com>
@aduermael
Copy link
Contributor Author

@sanscontext That's intended.
We need redirects for links on external websites not too be broken, but internally, it would be better be able to build a website that never (or almost never) needs them.
Also, it's easier to test...
Still I will add some tests later for all our redirects, to make sure none of them are broken, and that we don't have circular redirects. :)

sanscontext pushed a commit that referenced this issue Jan 11, 2017
@sanscontext
Copy link
Contributor

Merged #1088, whittling away. I can probably take another crack at these with a regex tbh. Most of them are from reorg into the engine subfolder.

@johndmulhausen
Copy link

@sanscontext Thanks for whittling at this.
@aduermael Does the original post have the latest broken links report, after the work of @sanscontext ?

@aduermael
Copy link
Contributor Author

@johndmulhausen I just updated it, I was waiting for #1052 CI to run tests. :)
Thanks @sanscontext!

@aduermael
Copy link
Contributor Author

It got much smaller! (used to be 147 lines, now 51!) 💪

@aduermael
Copy link
Contributor Author

@johndmulhausen about this one:

html_test.go:55: /allpagelinks/index.html
		broken: <a href="404.md">

Are you sure we don't want to link to /404.md instead? (that one exists)

@sanscontext
Copy link
Contributor

Okay, I think we're down to the core engine issues, the 404 and some api docs (layouts?) stuff, and the question of where to point the 'datacenter' urls (do we make a latest?)

@aduermael
Copy link
Contributor Author

@sanscontext @johndmulhausen @joaofnfernandes I updated the list.

@aduermael
Copy link
Contributor Author

@joaofnfernandes there's still one broken link in /engine/userguide:

html_test.go:55: /engine/userguide/eng-image/image_management/index.html
		broken: <a href="/datacenter/dtr/2.1/index.md">

We don't pull that section from docker/docker it seems, so we can fix it ourselves.

Same comment for /engine/understanding-docker/index.html actually...

@joaofnfernandes
Copy link
Contributor

#1125 addresses those two

@aduermael
Copy link
Contributor Author

@joaofnfernandes @johndmulhausen @sanscontext

YES! I updated the logs, only 2 issues remaining! 🙂

html_test.go:55: /allpagelinks/index.html
	broken: <a href="404.md">
html_test.go:55: /apidocs/overview/index.html
	broken: <a href="apidocs/overview.md" class="button darkblue-btn nomunge" style="color:#FFFFFF; width:100%; margin: 0px;">

I suggest we remove 404.md from allpagelinks.md.

@joaofnfernandes is working on a fix for the second one.

@aduermael
Copy link
Contributor Author

@joaofnfernandes any progression on your fix for edit buttons?

@joaofnfernandes
Copy link
Contributor

It seems the build for that PR failed while fetching from github. Will try to re-run the build.

@aduermael
Copy link
Contributor Author

@joaofnfernandes Cool! I tested your changes, it seems to be working! :)

So only that one remains:

html_test.go:55: /allpagelinks/index.html
	broken: <a href="404.md">

I would like to simply remove it from allpagelink.md... (adding an exception because it's generated)

cc @johndmulhausen

@aduermael
Copy link
Contributor Author

@joaofnfernandes thanks! just rebased #1052, I'll update the logs.

johndmulhausen added a commit that referenced this issue Jan 19, 2017
* d4mac, d4win stable 1.12.5 and beta 34 updates

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* fix punctuation typos (#949)

Signed-off-by: Jie Luo <luo612@zju.edu.cn>

* fix the error of handing a and an (#953)

* delete error asterisk (#947)

Signed-off-by: tim-zju <21651152@zju.edu.cn>

* fix the grammer in aws.md (#948)

* fix the grammer in aws.md

* a and an

* modify the user name (#946)

* Update create-swarm.md (#954)

Removes some spaces that were apparently b0rking the code block there.

* Add release notes for DTR 2.1.3

* spell errors: misusing a and an

Signed-off-by: tim-zju <21651152@zju.edu.cn>

* duplicated the (#957)

Signed-off-by: Jie Luo <luo612@zju.edu.cn>

* Lossless Image optimization (#959)

* re-compress jpg images losslessly using jpegoptim

* re-compress png images losslessly using zopflipng

* Add release notes for 1.12.5-cs

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* Fix wrong entry for DTR in robots.txt

* Update step_four.md

* fix typo

* Replace dtr-load-balancer by dtr-external-url

Fixes #961

* explained how to pin whale to taskbar

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* updated d4mac release notes re: hotfix

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Clean up some big, old files

* Fix typo on engine/getstarted/step_four.md

* Update gcs.md

Forgotten </td> caused table explosion

* Use armhf/hello-world for Raspbian tutorial

Signed-off-by: Stefan Scherer <scherer_stefan@icloud.com>

* added test for absolute links to docs.docker.com

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* made absolute links to docs.docker.com relative

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed absolute link in engin/installation/binaries

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* changes in Jenkinsfile

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* look for href and src attributes in a and img tags

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* look for absolute links to docs.docker.com

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* forgotten absolute links in Dockerfile

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* updated docs.docker.com absolute links test

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Revert "forgotten absolute links in Dockerfile"

This reverts commit ca54f76.

We want to fix the root cause, not the symptoms. So let’s make sure original content is fine instead of fixing it at build.

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* exclude archives when testing urls for now

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* CI: don’t build jekyll redirects for now

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Updated format for comments in Jenkinsfile

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* tests: Go deps are now vendored as submodules

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Jenkinsfile: init submodules

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed submodules

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* made absolute links to docs.docker.com relative

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* missing “target=_blank”

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* links to md files

as requested by @mstanleyjones

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* typo fixed

* Update host_integration.md

Typically, when you run an image from the command line, you would use "-d" for "detached mode", and when that appears to work, someone might paste the working command line into "ExecStart", which would then mysteriously fail because ExecStart expects a foreground process.

* Excess '>' symbol deleted

* Sometime the disk can become full and you can't rebalance.  Adding this step to the configuration instructions to help prevent users from getting in to a state which their device becomes full.

Moved to the performance section.

Signed-off-by: charlescva <charlieott@gmail.com>

* added user question in FAQ re: shared drives and Docker Machine nodes

copyedit

incorporated Misty's review comments

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Standardize formatting and content, add logging examples

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Update index.md

fix the typo

* Update deploy-to-cloud-btn.md

Add note about having to be logged into Docker Cloud...

* fixed note formatting

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* update d4mac, d4win intros, add better feedback topics

copyedits

more copyedits

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Replace bash shell to powershell in docker for windows

Signed-off-by: yuexiao-wang <wang.yuexiao@zte.com.cn>

* Update overview.md

Update overview.md to reference possible issues regarding windows to unix path convert issues

* Update ubuntulinux.md

* Improved description for Hello-World

Adds more detail for people to be able to understand how to build the Hello World using FROM scratch.

* Update services.md

Correct typographical error.

* Correct wrong default value

* fixes #1014 by adding flag

Signed-off-by: LRubin <lrubin@docker.com>

* small clarifications

Signed-off-by: LRubin <lrubin@docker.com>

* update swarm worker node concept description

incorporated review comments from Misty

re-worded topic titles and added to description of node

fixed links for services and tasks

incorporated more comments

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update to usingdocker.md

Link destination changed toa more appropriate (imo) destination.

Link originally linked to docker env varibles whereas link description describes other docker commands.

* Updating dockervolumes.md for Windows mounting

The code snippet for mounting Windows directories won't work: it will produce an "Invalid bind mount spec" error as Docker cannot properly read the path. The core error was addressed in [#12590](moby/moby#12590 (comment)), this is just an update to the tutorial.

* using github url for yaml.v2 submodule (#1034)

in an attempt to fix Github pages build…

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* clarify docker-cloud install

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Add flag to ucp 2.0 restore instructions

* Add flag to ucp 2.0 restore instructions

* update Docker machine install instructions per user feedback

added uninstall steps

fixed line lengths

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Typo in ubuntulinux.md (#1041)

* version changed to 1.12.3 (#1036)

* update the version in the code snnipt (#1037)

* docker upgrade command fix (#1044)

`apt-get upgrade` doesn't take an argument. To upgrade docker specifically would require `apt-get install docker-engine`.

* accross -> across

* beta 35 release notes d4mac, d4win

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Remove duplicate 'for details' 

Remove duplicate 'for details' in Docker Daemon Attack Surface line.

* Update automated-testing.md

Updated text to reflect that the `docker-compose.test.yml` file needs to be in the same directory as the Dockerfile used to build the image.

* Add prereqs to AUFS configuration steps

Fixes #1061

* Add the info about the linux-image-extra packages

* Fix typo (are -> area) (#1058)

* Fix title (#1056)

The title is not rendered correctly because of the missing newline

* Fix small typo in step_four.md. (#1053)

* Fix DDC broken links reported on #1068

* Update networkingcontainers.md

* Change title (#1073)

* urls (#1074)

Signed-off-by: yupengzte <yu.peng36@zte.com.cn>

* fixed links in /apidocs/docker-cloud/includes

urls in html files that are included must be absolute, otherwise it only works when the files are included in some specific location.

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* cf6fc37 fix had to be made in /apidocs/cloud-api-source

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* url fixes for #1068

Signed-off-by: LRubin <lrubin@docker.com>

* Fixes #1086

* more link fixes

Signed-off-by: LRubin <lrubin@docker.com>

* exclude /apidocs/cloud-api-source when building

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* more more link link fixes fixes

Signed-off-by: LRubin <lrubin@docker.com>

* docker is no longer optional in this tutorial

Signed-off-by: LRubin <lrubin@docker.com>

* format fix and light rewording

Signed-off-by: LRubin <lrubin@docker.com>

* Always use sudo on Debian installation

* docker-for-mac: add a FAQ about reducing the qcow2 size

In Docker for Mac 1.12 the only way to free space on the host is to
delete the qcow2 which means all containers and images have to be
rebuilt.

In Docker for Mac 1.13 there is preliminary support for shrinking the
qcow2 file non-destructively using "TRIM" (as also used on SSDs).
Unfortunately this isn't (yet) fully automatic -- it runs in the
background and requires the app to be occasionally restarted.

Related to [docker/for-mac#371]

Signed-off-by: David Scott <dave.scott@docker.com>

* Update instructions for systemd drop-ins

When creating a `/etc/systemd/system/docker.service`
unit file, that file _replaces_ the default
(`/lib/systemd/system/docker.service`) unit file.

While this may be intended by some, this section
describes how to use "partial" unit files ("drop-ins")
to override only certain properties of the default
unit file.

This patch removes the mention of
`/etc/systemd/system/docker.service` to prevent
users from inadvertently replacing the default
unit file.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Add cs-engine 1.12.6-cs6 release notes

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* Add new redirect for DTR install

* Add 1.11.2-cs6 release notes

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* Updates broken links for #1068

* added links to Toolbox installer downloads via Releases page

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update links to DTR

* tag images and containers with JOB_BASE_NAME + BUILD_NUMBER

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Add release notes for 1.10.3-cs4

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* added direct installer links, re-worked Toolbox intro pages

updated Toolbox install intros

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Remove reference to legacy container links (#1057)

* Removes duplicate canonical urls

* Fix root_ca, json structure (#1079)

Signed-off-by: Riyaz Faizullabhoy <riyaz.faizullabhoy@docker.com>

* Correction of the Install-Module command (#1102)

The command line was Import-Module which seems to be wrong. It seemed to work for me with Install-Module. So I make the correction. Please note, I'm only a newbie, so check this twice please ;-)

* linked to related GitHub issue, slight re-ordering of topics

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update PULL_REQUEST_TEMPLATE.md (#1106)

Change 'left' to 'right' (because that's where the referenced information is located.

* Add alternative keyservers due to #13555 (#1048)

* Update step_six.md (#1105)

* Update get-started-macvlan.md

fix typo

* added beta 36 relnotes, and minor wording updates to Docker.qcow2 question in Mac FAQs

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* clarify Toolbox install per Nathan's comments

centered download buttons for overview Toolbox install

improved Get Docker intro in Getting Started tutorial

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Fixed more broken links

* fix typo in get-started-macvlan.md (#1121)

* added Linux Kernel upgrade to relnotes

added new bug fix item

toolbox fixes

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update get-started-overlay.md (#1082)

* Update get-started-overlay.md

* Update get-started-overlay.md

perhaps renderer can't do multiline markdown links

* Update get-started-overlay.md

* Remove 'edit this page' button when there's no source file

* Adds dynamically-generated redirect_from.csv to root for nginx consumption

* Correct typo

"For image" changed to "For instance"

* Update hyper-v.md

* correct some spelling mistake

* fix typo in swarm tutorial

* Correct Python application port for local browsing

* Updates allpagelinks.md to use full paths (#1143)

* Fix documentation regarding protocol 50 (ESP) (#1144)

The documentation should clarify that its protocol 50 and not port 50 that should be allowed between nodes.

* Update mongodb.md (#1122)

In older version docker build was failing.

* CI - added tests for relative links [DO NOT MERGE] (#1052)

* CI - added tests for relative links

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixes to check relative links properly

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* /engine/extend/plugins/ -> /engine/extend/legacy_plugins/

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* do not build /tests folder with Jekyll…

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* list all problematic urls in each file

don’t stop at first error encountered

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* removed “stack tasks” from menu (toc.yaml)

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed broken links

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed broken link in docker-for-mac/osxfs.md

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed broken links in /index.html

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Add release notes for DTR 2.1.4

* Fix offline DDC install

* Add offline tarfile for DTR 2.1.4

* Update instructions for IPv6-enabled networks

Signed-off-by: Joffrey F <joffrey@docker.com>

* Fix searches not running on Enter, CS Release notes

* Restart the docker daemon after group changes

Otherwise the verification step won't work.

* Remove quotation marks

Remove quotation marks around environment variable export for DOCKERCLOUD_NAMESPACE

* optimize  selectadriver.md

* Permission Levels Full Control Warning (UCP 2.0)

* Full Control Users Warning (UCP 1.1)

* improve readability of note

Signed-off-by: LRubin <lrubin@docker.com>

* Update release notes for UCP 2.0.2

* Release notes for UCP 1.1.6

* replaces edit from #979

Signed-off-by: LRubin <lrubin@docker.com>

* Update 2_set_up.md

* adds more info about valid docker ID

Signed-off-by: LRubin <lrubin@docker.com>

* fix typo

* Update 'usingdocker' tutorial to name the container

Do some clean-up while I'm in there

* swarm beta docs for limited publish

Signed-off-by: LRubin <lrubin@docker.com>

* Clarify the command only for docker-machine (#1149)

* Clarify the command only for docker-machine

* minor copyedits (#1148)

* minor copyedits

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Revert "Restart the docker daemon after group changes"

* take a stab at fixing a broken link

Signed-off-by: LRubin <lrubin@docker.com>

* Release Engine 1.13 documentation (#1187)

* Sync vnext-engine branch to docker/docker SHA 2f12d28

This branch will contain forward-looking Engine-specific docs
and be the equivalent of docker/docker master for docs

* swarm: Document rollback, failure threshold, and monitor flags

These are new flags to service create/update being added in a Docker
engine PR.

Signed-off-by: Aaron Lehmann <aaron.lehmann@docker.com>

* Remove Fedora 22 as it's EOL

https://fedoramagazine.org/fedora-22-end-of-life-2016-july/

With the recent release of Fedora 24, Fedora 22 will officially enter End Of
Life (EOL) status on July 19th, 2016. After July 19th, all packages in the
Fedora 22 repositories will no longer receive security, bugfix, or enhancement
updates, and no new packages will be added to the Fedora 22 collection.

Upgrading to Fedora 23 or Fedora 24 before July 19th 2016 is highly recommended
for all users still running Fedora 22.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* update apparmor documentation to reflect changes in 1.13.0

Updates the apparmor docs to reflect recent changes, specifically that
we are no longer saving to /etc/apparmor.d/. Also removes the seccomp
profile and instead links to the generating template.

Signed-off-by: Christopher Jones <tophj@linux.vnet.ibm.com>

* Added details about tag support for AWS log driver

Signed-off-by: French Ben <frenchben@docker.com>

* Changed wording for tag description

* Updated docs to show full container ID

* Updated wording on log stream default

Signed-off-by: French Ben <frenchben@docker.com>

* Added raw tags

Signed-off-by: French Ben <frenchben@docker.com>

* Update note about custom certs with system certs

Fixed incorrect statement about example layout

Related to moby/moby#27918

Signed-off-by: Derek McGowan <derek@mcgstyle.net> (github: dmcgowan)

* Remove Ubuntu 15.10 Wily Werewolf

As of July 28, 2016, Ubuntu 15.10 is officially EOL
(https://lists.ubuntu.com/archives/ubuntu-announce/2016-July/000210.html),
and will receive no further updates.

Support for 15.10 was removed in Docker 1.13 through
moby/moby#27042

(moby/moby@e9a8105)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Add Ubuntu 16.10 Yakkety Yak

Support for Ubuntu 16.10 was added in
moby/moby#27993
(moby/moby@27beb64)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* add unix-sockets support in Fluentd logging driver

Signed-off-by: Akira Koyasu <mail@akirakoyasu.net>

* Add engine changes that were lost in syncing

When syncing docs from the docker/docker repository (e4bce35)
some commits were not included. This includes those changes, by copying the documentation from

moby/moby@8658748,
which is the last commit before the docs were removed from the docker/docker
repository in moby/moby@29f08cf

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Create logentries.md (#244)

* Create logentries.md

Signed-off-by: Carlos Alexandro Becker <caarlos0@gmail.com>

* Add NATS client as option for publishing container logs (#369)

* Add NATS client as option for publishing container logs

Signed-off-by: Waldemar Quevedo <waldemar.quevedo@gmail.com>

* Document ability to update a service's image

Fixes #528

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* First version of stack deployment tutorial

Signed-off-by: Aanand Prasad <aanand.prasad@gmail.com>

* Initial dump of CLI in yaml (#737)

Signed-off-by: French Ben <frenchben@docker.com>

* Document new CPU scheduling flags

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Update dockerfile vnext (#874)

* Merge pull request #731 from mstanleyjones/distribution_docs_from_upstream

Pull distribution reference docs from upstream repo

* Bump Engine ref docs branch to 1.13.x

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Rename Remote API to Engine API

See moby/moby#28319

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Move accounts API docs to Docker ID section

Makes more sense here instead of the Engine reference. It is
only consumed by the Engine.

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Add automatically generated Engine API docs

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Upgrade to ReDoc 1.6.2 (#891)

To make use of x-displayName added in
moby/moby#29401

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Add full documentation for APIs and SDKs

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Updated Yaml files (#922)

Signed-off-by: French Ben <frenchben@docker.com>

* Added latest docs from Editions AWS & Azure (#887)

* Added Docker for AWS and Azure and moved navigation

Signed-off-by: French Ben <frenchben@docker.com>

* Fixed image links

Signed-off-by: French Ben <frenchben@docker.com>

* Restructure navigation for Editions

* Fixing double curly braces

* YAML-sourced CLI refdocs

* Add 'docker' label to commands

* Fix for blank node

* Document Docker secrets

Fixes #529

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Update syntax of the -f flag in the examples

* Update the syntax of 'docker secret create' in the examples

* Document the ability to publish a port locally on a swarm node

* Add info about image resolution with content trust

* Add examples to CLI generation templates

* remove confusing sentence from "publishing" section

the routing mesh should work irregardless of all
replicas being up or not, so removing this sentence.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Rewrite and reorganize Linux install instructions

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Fix typo in Oracle install instructions

* Updated docs to remove beta and stable link (#1160)

* Updated docs to remove beta and stable link

* Addressing feedback from new installation instructions (#1172)

* Address feedback for new installation instructions

* Updating the repo files for Oracle since  does not expand to only the number

* Added latest docs from Editions AWS & Azure (#887)

* Added Docker for AWS and Azure and moved navigation

Signed-off-by: French Ben <frenchben@docker.com>

* Fixed image links

Signed-off-by: French Ben <frenchben@docker.com>

* Restructure navigation for Editions

* Fix a couple of Liquid errors

* Merge pull request #1188 from docker/linkfix-john

Link fixes and link to app tutorial
johndmulhausen pushed a commit that referenced this issue Jan 19, 2017
* fix punctuation typos (#949)

Signed-off-by: Jie Luo <luo612@zju.edu.cn>

* fix the error of handing a and an (#953)

* delete error asterisk (#947)

Signed-off-by: tim-zju <21651152@zju.edu.cn>

* fix the grammer in aws.md (#948)

* fix the grammer in aws.md

* a and an

* modify the user name (#946)

* Update create-swarm.md (#954)

Removes some spaces that were apparently b0rking the code block there.

* Add release notes for DTR 2.1.3

* spell errors: misusing a and an

Signed-off-by: tim-zju <21651152@zju.edu.cn>

* duplicated the (#957)

Signed-off-by: Jie Luo <luo612@zju.edu.cn>

* Lossless Image optimization (#959)

* re-compress jpg images losslessly using jpegoptim

* re-compress png images losslessly using zopflipng

* Add release notes for 1.12.5-cs

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* Fix wrong entry for DTR in robots.txt

* Update step_four.md

* fix typo

* Replace dtr-load-balancer by dtr-external-url

Fixes #961

* explained how to pin whale to taskbar

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* updated d4mac release notes re: hotfix

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Clean up some big, old files

* Fix typo on engine/getstarted/step_four.md

* Update gcs.md

Forgotten </td> caused table explosion

* Use armhf/hello-world for Raspbian tutorial

Signed-off-by: Stefan Scherer <scherer_stefan@icloud.com>

* added test for absolute links to docs.docker.com

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* made absolute links to docs.docker.com relative

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed absolute link in engin/installation/binaries

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* changes in Jenkinsfile

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* look for href and src attributes in a and img tags

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* look for absolute links to docs.docker.com

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* forgotten absolute links in Dockerfile

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* updated docs.docker.com absolute links test

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Revert "forgotten absolute links in Dockerfile"

This reverts commit ca54f76.

We want to fix the root cause, not the symptoms. So let’s make sure original content is fine instead of fixing it at build.

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* exclude archives when testing urls for now

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* CI: don’t build jekyll redirects for now

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Updated format for comments in Jenkinsfile

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* tests: Go deps are now vendored as submodules

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Jenkinsfile: init submodules

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed submodules

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* made absolute links to docs.docker.com relative

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* missing “target=_blank”

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* links to md files

as requested by @mstanleyjones

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* typo fixed

* Update host_integration.md

Typically, when you run an image from the command line, you would use "-d" for "detached mode", and when that appears to work, someone might paste the working command line into "ExecStart", which would then mysteriously fail because ExecStart expects a foreground process.

* Excess '>' symbol deleted

* Sometime the disk can become full and you can't rebalance.  Adding this step to the configuration instructions to help prevent users from getting in to a state which their device becomes full.

Moved to the performance section.

Signed-off-by: charlescva <charlieott@gmail.com>

* added user question in FAQ re: shared drives and Docker Machine nodes

copyedit

incorporated Misty's review comments

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Standardize formatting and content, add logging examples

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Update index.md

fix the typo

* Update deploy-to-cloud-btn.md

Add note about having to be logged into Docker Cloud...

* fixed note formatting

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* update d4mac, d4win intros, add better feedback topics

copyedits

more copyedits

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Replace bash shell to powershell in docker for windows

Signed-off-by: yuexiao-wang <wang.yuexiao@zte.com.cn>

* Update overview.md

Update overview.md to reference possible issues regarding windows to unix path convert issues

* Update ubuntulinux.md

* Improved description for Hello-World

Adds more detail for people to be able to understand how to build the Hello World using FROM scratch.

* Update services.md

Correct typographical error.

* Correct wrong default value

* fixes #1014 by adding flag

Signed-off-by: LRubin <lrubin@docker.com>

* small clarifications

Signed-off-by: LRubin <lrubin@docker.com>

* update swarm worker node concept description

incorporated review comments from Misty

re-worded topic titles and added to description of node

fixed links for services and tasks

incorporated more comments

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update to usingdocker.md

Link destination changed toa more appropriate (imo) destination.

Link originally linked to docker env varibles whereas link description describes other docker commands.

* Updating dockervolumes.md for Windows mounting

The code snippet for mounting Windows directories won't work: it will produce an "Invalid bind mount spec" error as Docker cannot properly read the path. The core error was addressed in [#12590](moby/moby#12590 (comment)), this is just an update to the tutorial.

* using github url for yaml.v2 submodule (#1034)

in an attempt to fix Github pages build…

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* clarify docker-cloud install

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Add flag to ucp 2.0 restore instructions

* Add flag to ucp 2.0 restore instructions

* update Docker machine install instructions per user feedback

added uninstall steps

fixed line lengths

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Typo in ubuntulinux.md (#1041)

* version changed to 1.12.3 (#1036)

* update the version in the code snnipt (#1037)

* docker upgrade command fix (#1044)

`apt-get upgrade` doesn't take an argument. To upgrade docker specifically would require `apt-get install docker-engine`.

* accross -> across

* beta 35 release notes d4mac, d4win

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Remove duplicate 'for details' 

Remove duplicate 'for details' in Docker Daemon Attack Surface line.

* Update automated-testing.md

Updated text to reflect that the `docker-compose.test.yml` file needs to be in the same directory as the Dockerfile used to build the image.

* Add prereqs to AUFS configuration steps

Fixes #1061

* Add the info about the linux-image-extra packages

* Fix typo (are -> area) (#1058)

* Fix title (#1056)

The title is not rendered correctly because of the missing newline

* Fix small typo in step_four.md. (#1053)

* Fix DDC broken links reported on #1068

* Update networkingcontainers.md

* Change title (#1073)

* urls (#1074)

Signed-off-by: yupengzte <yu.peng36@zte.com.cn>

* fixed links in /apidocs/docker-cloud/includes

urls in html files that are included must be absolute, otherwise it only works when the files are included in some specific location.

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* cf6fc37 fix had to be made in /apidocs/cloud-api-source

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* url fixes for #1068

Signed-off-by: LRubin <lrubin@docker.com>

* Fixes #1086

* more link fixes

Signed-off-by: LRubin <lrubin@docker.com>

* exclude /apidocs/cloud-api-source when building

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* more more link link fixes fixes

Signed-off-by: LRubin <lrubin@docker.com>

* docker is no longer optional in this tutorial

Signed-off-by: LRubin <lrubin@docker.com>

* format fix and light rewording

Signed-off-by: LRubin <lrubin@docker.com>

* Always use sudo on Debian installation

* docker-for-mac: add a FAQ about reducing the qcow2 size

In Docker for Mac 1.12 the only way to free space on the host is to
delete the qcow2 which means all containers and images have to be
rebuilt.

In Docker for Mac 1.13 there is preliminary support for shrinking the
qcow2 file non-destructively using "TRIM" (as also used on SSDs).
Unfortunately this isn't (yet) fully automatic -- it runs in the
background and requires the app to be occasionally restarted.

Related to [docker/for-mac#371]

Signed-off-by: David Scott <dave.scott@docker.com>

* Update instructions for systemd drop-ins

When creating a `/etc/systemd/system/docker.service`
unit file, that file _replaces_ the default
(`/lib/systemd/system/docker.service`) unit file.

While this may be intended by some, this section
describes how to use "partial" unit files ("drop-ins")
to override only certain properties of the default
unit file.

This patch removes the mention of
`/etc/systemd/system/docker.service` to prevent
users from inadvertently replacing the default
unit file.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Add cs-engine 1.12.6-cs6 release notes

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* Add new redirect for DTR install

* Add 1.11.2-cs6 release notes

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* Updates broken links for #1068

* added links to Toolbox installer downloads via Releases page

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update links to DTR

* tag images and containers with JOB_BASE_NAME + BUILD_NUMBER

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Add release notes for 1.10.3-cs4

Signed-off-by: Brian Goff <cpuguy83@gmail.com>

* added direct installer links, re-worked Toolbox intro pages

updated Toolbox install intros

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Remove reference to legacy container links (#1057)

* Removes duplicate canonical urls

* Fix root_ca, json structure (#1079)

Signed-off-by: Riyaz Faizullabhoy <riyaz.faizullabhoy@docker.com>

* Correction of the Install-Module command (#1102)

The command line was Import-Module which seems to be wrong. It seemed to work for me with Install-Module. So I make the correction. Please note, I'm only a newbie, so check this twice please ;-)

* linked to related GitHub issue, slight re-ordering of topics

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update PULL_REQUEST_TEMPLATE.md (#1106)

Change 'left' to 'right' (because that's where the referenced information is located.

* Add alternative keyservers due to #13555 (#1048)

* Update step_six.md (#1105)

* Update get-started-macvlan.md

fix typo

* added beta 36 relnotes, and minor wording updates to Docker.qcow2 question in Mac FAQs

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* clarify Toolbox install per Nathan's comments

centered download buttons for overview Toolbox install

improved Get Docker intro in Getting Started tutorial

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Fixed more broken links

* fix typo in get-started-macvlan.md (#1121)

* added Linux Kernel upgrade to relnotes

added new bug fix item

toolbox fixes

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Update get-started-overlay.md (#1082)

* Update get-started-overlay.md

* Update get-started-overlay.md

perhaps renderer can't do multiline markdown links

* Update get-started-overlay.md

* Remove 'edit this page' button when there's no source file

* Adds dynamically-generated redirect_from.csv to root for nginx consumption

* Correct typo

"For image" changed to "For instance"

* Update hyper-v.md

* correct some spelling mistake

* fix typo in swarm tutorial

* Correct Python application port for local browsing

* Updates allpagelinks.md to use full paths (#1143)

* Fix documentation regarding protocol 50 (ESP) (#1144)

The documentation should clarify that its protocol 50 and not port 50 that should be allowed between nodes.

* Update mongodb.md (#1122)

In older version docker build was failing.

* CI - added tests for relative links [DO NOT MERGE] (#1052)

* CI - added tests for relative links

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixes to check relative links properly

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* /engine/extend/plugins/ -> /engine/extend/legacy_plugins/

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* do not build /tests folder with Jekyll…

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* list all problematic urls in each file

don’t stop at first error encountered

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* removed “stack tasks” from menu (toc.yaml)

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed broken links

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed broken link in docker-for-mac/osxfs.md

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed broken links in /index.html

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* Add release notes for DTR 2.1.4

* Fix offline DDC install

* Add offline tarfile for DTR 2.1.4

* Update instructions for IPv6-enabled networks

Signed-off-by: Joffrey F <joffrey@docker.com>

* Fix searches not running on Enter, CS Release notes

* Restart the docker daemon after group changes

Otherwise the verification step won't work.

* Remove quotation marks

Remove quotation marks around environment variable export for DOCKERCLOUD_NAMESPACE

* optimize  selectadriver.md

* Permission Levels Full Control Warning (UCP 2.0)

* Full Control Users Warning (UCP 1.1)

* improve readability of note

Signed-off-by: LRubin <lrubin@docker.com>

* Update release notes for UCP 2.0.2

* Release notes for UCP 1.1.6

* replaces edit from #979

Signed-off-by: LRubin <lrubin@docker.com>

* Update 2_set_up.md

* adds more info about valid docker ID

Signed-off-by: LRubin <lrubin@docker.com>

* fix typo

* Update 'usingdocker' tutorial to name the container

Do some clean-up while I'm in there

* swarm beta docs for limited publish

Signed-off-by: LRubin <lrubin@docker.com>

* Clarify the command only for docker-machine (#1149)

* Clarify the command only for docker-machine

* minor copyedits (#1148)

* minor copyedits

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* Revert "Restart the docker daemon after group changes"

* take a stab at fixing a broken link

Signed-off-by: LRubin <lrubin@docker.com>

* Release Engine 1.13 documentation (#1187)

* Sync vnext-engine branch to docker/docker SHA 2f12d28

This branch will contain forward-looking Engine-specific docs
and be the equivalent of docker/docker master for docs

* swarm: Document rollback, failure threshold, and monitor flags

These are new flags to service create/update being added in a Docker
engine PR.

Signed-off-by: Aaron Lehmann <aaron.lehmann@docker.com>

* Remove Fedora 22 as it's EOL

https://fedoramagazine.org/fedora-22-end-of-life-2016-july/

With the recent release of Fedora 24, Fedora 22 will officially enter End Of
Life (EOL) status on July 19th, 2016. After July 19th, all packages in the
Fedora 22 repositories will no longer receive security, bugfix, or enhancement
updates, and no new packages will be added to the Fedora 22 collection.

Upgrading to Fedora 23 or Fedora 24 before July 19th 2016 is highly recommended
for all users still running Fedora 22.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* update apparmor documentation to reflect changes in 1.13.0

Updates the apparmor docs to reflect recent changes, specifically that
we are no longer saving to /etc/apparmor.d/. Also removes the seccomp
profile and instead links to the generating template.

Signed-off-by: Christopher Jones <tophj@linux.vnet.ibm.com>

* Added details about tag support for AWS log driver

Signed-off-by: French Ben <frenchben@docker.com>

* Changed wording for tag description

* Updated docs to show full container ID

* Updated wording on log stream default

Signed-off-by: French Ben <frenchben@docker.com>

* Added raw tags

Signed-off-by: French Ben <frenchben@docker.com>

* Update note about custom certs with system certs

Fixed incorrect statement about example layout

Related to moby/moby#27918

Signed-off-by: Derek McGowan <derek@mcgstyle.net> (github: dmcgowan)

* Remove Ubuntu 15.10 Wily Werewolf

As of July 28, 2016, Ubuntu 15.10 is officially EOL
(https://lists.ubuntu.com/archives/ubuntu-announce/2016-July/000210.html),
and will receive no further updates.

Support for 15.10 was removed in Docker 1.13 through
moby/moby#27042

(moby/moby@e9a8105)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Add Ubuntu 16.10 Yakkety Yak

Support for Ubuntu 16.10 was added in
moby/moby#27993
(moby/moby@27beb64)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* add unix-sockets support in Fluentd logging driver

Signed-off-by: Akira Koyasu <mail@akirakoyasu.net>

* Add engine changes that were lost in syncing

When syncing docs from the docker/docker repository (e4bce35)
some commits were not included. This includes those changes, by copying the documentation from

moby/moby@8658748,
which is the last commit before the docs were removed from the docker/docker
repository in moby/moby@29f08cf

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Create logentries.md (#244)

* Create logentries.md

Signed-off-by: Carlos Alexandro Becker <caarlos0@gmail.com>

* Add NATS client as option for publishing container logs (#369)

* Add NATS client as option for publishing container logs

Signed-off-by: Waldemar Quevedo <waldemar.quevedo@gmail.com>

* Document ability to update a service's image

Fixes #528

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* First version of stack deployment tutorial

Signed-off-by: Aanand Prasad <aanand.prasad@gmail.com>

* Initial dump of CLI in yaml (#737)

Signed-off-by: French Ben <frenchben@docker.com>

* Document new CPU scheduling flags

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Update dockerfile vnext (#874)

* Merge pull request #731 from mstanleyjones/distribution_docs_from_upstream

Pull distribution reference docs from upstream repo

* Bump Engine ref docs branch to 1.13.x

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Rename Remote API to Engine API

See moby/moby#28319

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Move accounts API docs to Docker ID section

Makes more sense here instead of the Engine reference. It is
only consumed by the Engine.

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Add automatically generated Engine API docs

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Upgrade to ReDoc 1.6.2 (#891)

To make use of x-displayName added in
moby/moby#29401

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Add full documentation for APIs and SDKs

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

* Updated Yaml files (#922)

Signed-off-by: French Ben <frenchben@docker.com>

* Added latest docs from Editions AWS & Azure (#887)

* Added Docker for AWS and Azure and moved navigation

Signed-off-by: French Ben <frenchben@docker.com>

* Fixed image links

Signed-off-by: French Ben <frenchben@docker.com>

* Restructure navigation for Editions

* Fixing double curly braces

* YAML-sourced CLI refdocs

* Add 'docker' label to commands

* Fix for blank node

* Document Docker secrets

Fixes #529

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Update syntax of the -f flag in the examples

* Update the syntax of 'docker secret create' in the examples

* Document the ability to publish a port locally on a swarm node

* Add info about image resolution with content trust

* Add examples to CLI generation templates

* remove confusing sentence from "publishing" section

the routing mesh should work irregardless of all
replicas being up or not, so removing this sentence.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Rewrite and reorganize Linux install instructions

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

* Fix typo in Oracle install instructions

* Updated docs to remove beta and stable link (#1160)

* Updated docs to remove beta and stable link

* Addressing feedback from new installation instructions (#1172)

* Address feedback for new installation instructions

* Updating the repo files for Oracle since  does not expand to only the number

* Added latest docs from Editions AWS & Azure (#887)

* Added Docker for AWS and Azure and moved navigation

Signed-off-by: French Ben <frenchben@docker.com>

* Fixed image links

Signed-off-by: French Ben <frenchben@docker.com>

* Restructure navigation for Editions

* Fix a couple of Liquid errors

* Merge pull request #1188 from docker/linkfix-john

Link fixes and link to app tutorial

* Nav fixes
@johndmulhausen
Copy link

johndmulhausen commented Jan 23, 2017

Tests still failing; @mstanleyjones @sanscontext @aduermael @joaofnfernandes @londoncalling

10:39:12 --- FAIL: TestURLs (4.75s)
10:39:12 	html_test.go:55: /compose/compose-file/index.html
10:39:12 		broken: <a href="/engine/userguide/dockervolumes.md">
10:39:12 	html_test.go:55: /compose/django/index.html
10:39:12 		broken: <a href="/engine/tutorials/dockerimages.md#building-an-image-from-a-dockerfile">
10:39:12 	html_test.go:55: /compose/gettingstarted/index.html
10:39:12 		broken: <a href="/engine/tutorials/dockerimages.md#building-an-image-from-a-dockerfile">
10:39:12 	html_test.go:55: /compose/install/index.html
10:39:12 		broken: <a href="/engine/installation/mac/" target="_blank">
10:39:12 		broken: <a href="/engine/installation/windows/" target="_blank">
10:39:12 	html_test.go:55: /compose/rails/index.html
10:39:12 		broken: <a href="/engine/tutorials/dockerimages.md#building-an-image-from-a-dockerfile">
10:39:12 	html_test.go:55: /docker-for-mac/faqs/index.html
10:39:12 		broken: <a href="/engine/reference/api/docker_remote_api.md">
10:39:12 	html_test.go:55: /docker-for-mac/index.html
10:39:12 		broken: <a href="/engine/reference/index.md">
10:39:12 	html_test.go:55: /docker-for-windows/faqs/index.html
10:39:12 		broken: <a href="/engine/reference/api/">
10:39:12 	html_test.go:55: /docker-for-windows/index.html
10:39:12 		broken: <a href="/engine/reference/index.md">
10:39:12 	html_test.go:55: /docker-hub/index.html
10:39:12 		broken: <a href="/engine/tutorials/dockerimages/">
10:39:12 	html_test.go:55: /docker-hub/repos/index.html
10:39:12 		broken: <a href="/engine/tutorials/dockerimages/">
10:39:12 	html_test.go:55: /docker-id/index.html
10:39:12 		broken: <a href="../engine/reference/api/docker_io_accounts_api/">
10:39:12 	html_test.go:55: /engine/api/getting-started/index.html
10:39:12 		absolute: <a href="https://docs.docker.com/engine/installation/">
10:39:12 	html_test.go:55: /engine/deprecated/index.html
10:39:12 		absolute: <a href="https://docs.docker.com/engine/#feature-deprecation-policy">
10:39:12 		absolute: <a href="https://docs.docker.com/registry/recipes/mirror/">
10:39:12 	html_test.go:55: /engine/examples/index.html
10:39:12 		broken: <a href="../tutorials/dockerizing.md">
10:39:12 	html_test.go:55: /engine/extend/index.html
10:39:12 		broken: <a href="../reference/commandline/index.md">
10:39:12 	html_test.go:55: /engine/extend/plugins_graphdriver/index.html
10:39:12 		broken: <a href="/docs/extend/index.md">
10:39:12 	html_test.go:55: /engine/getstarted/last_page/index.html
10:39:12 		absolute: <a href="https://docs.docker.com/docker-hub/">
10:39:12 	html_test.go:55: /engine/getstarted-voting-app/node-setup/index.html
10:39:12 		broken: <a href="/engine/reference/commandline.md">
10:39:12 	html_test.go:55: /engine/getstarted-voting-app/test-drive/index.html
10:39:12 		broken: <a href="index#docker-stackyml">
10:39:12 	html_test.go:55: /engine/installation/binaries/index.html
10:39:12 		broken: <a href="linux-postinstall.md">
10:39:12 	html_test.go:55: /engine/installation/index.html
10:39:12 		broken: <a href="linux/SUSE.md">
10:39:12 	html_test.go:55: /engine/installation/linux/linux-postinstall/index.html
10:39:12 		broken: <a href="../userguide/storagedriver/index.md">
10:39:12 	html_test.go:55: /engine/reference/builder/index.html
10:39:12 		broken: <a href="/engine/tutorials/dockerrepos/#/contributing-to-docker-hub">
10:39:12 		broken: <a href="/engine/tutorials/dockerrepos/">
10:39:12 	html_test.go:55: /engine/reference/commandline/docker/index.html
10:39:12 		broken: <a href="checkpoint/">
10:39:12 	html_test.go:55: /engine/reference/commandline/dockerd/index.html
10:39:12 		broken: <a href="../api/docker_remote_api.md">
10:39:12 	html_test.go:55: /engine/reference/commandline/image_pull/index.html
10:39:12 		broken: <a href="/engine/reference/commandline/daemon/#insecure-registries">
10:39:12 	html_test.go:55: /engine/swarm/admin_guide/index.html
10:39:12 		broken: <a href="../reference/api/docker_remote_api_v1.24.md#36-nodes">
10:39:12 	html_test.go:55: /engine/swarm/how-swarm-mode-works/nodes/index.html
10:39:12 		broken: <a href="../../reference/api/index.md">
10:39:12 	html_test.go:55: /engine/swarm/manage-nodes/index.html
10:39:12 		broken: <a href="../reference/commandline/index.md">
10:39:12 	html_test.go:55: /engine/swarm/networking/index.html
10:39:12 		broken: <a href="../reference/commandline/index.md">
10:39:12 	html_test.go:55: /engine/swarm/services/index.html
10:39:12 		broken: <a href="security/trust/content_trust.md">
10:39:12 		broken: <a href="../reference/commandline/index.md">
10:39:12 	html_test.go:55: /engine/swarm/stack-deploy/index.html
10:39:12 		broken: <a href="how-swarm-mode- works/services.md">
10:39:12 	html_test.go:55: /engine/tutorials/dockervolumes/index.html
10:39:12 		broken: <a href="usingdocker.md">
10:39:12 		broken: <a href="dockerimages.md">
10:39:12 		broken: <a href="dockerrepos.md">
10:39:12 	html_test.go:55: /engine/tutorials/index.html
10:39:12 		broken: <a href="dockerizing.md">
10:39:12 		broken: <a href="usingdocker.md">
10:39:12 		broken: <a href="dockerimages.md">
10:39:12 		broken: <a href="dockerrepos.md">
10:39:12 	html_test.go:55: /engine/userguide/index.html
10:39:12 		broken: <a href="../tutorials/dockerizing.md">
10:39:12 		broken: <a href="../tutorials/dockerimages.md">
10:39:12 		broken: <a href="../tutorials/usingdocker.md">
10:39:12 		broken: <a href="../tutorials/dockerrepos.md">
10:39:12 	html_test.go:55: /engine/userguide/intro/index.html
10:39:12 		broken: <a href="../tutorials/dockerizing.md">
10:39:12 		broken: <a href="../tutorials/usingdocker.md">
10:39:12 		broken: <a href="../tutorials/dockerimages.md">
10:39:12 	html_test.go:55: /engine/userguide/networking/default_network/dockerlinks/index.html
10:39:12 		broken: <a href="../../../tutorials/usingdocker.md">
10:39:12 		broken: <a href="../../../tutorials/usingdocker.md">
10:39:12 	html_test.go:55: /index.html
10:39:12 		broken: <a href="engine/tutorials/dockerrepos.md">
10:39:12 	html_test.go:55: /machine/get-started/index.html
10:39:12 		broken: <a href="/engine/installation/mac/" target="_blank">
10:39:12 		broken: <a href="/engine/installation/windows/" target="_blank">
10:39:12 	html_test.go:55: /swarm/install-manual/index.html
10:39:12 		broken: <a href="/engine/installation/cloud/cloud-ex-aws/">
10:39:12 	html_test.go:55: /swarm/overview/index.html
10:39:12 		broken: <a href="/engine/reference/api/docker_remote_api/">
10:39:12 	html_test.go:55: /swarm/provision-with-machine/index.html
10:39:12 		broken: <a href="/engine/installation/mac/">
10:39:12 		broken: <a href="/engine/installation/mac/">
10:39:12 	html_test.go:55: /swarm/swarm-api/index.html
10:39:12 		broken: <a href="/engine/reference/api/docker_remote_api/">

^ This is blocking merges on a number of PRs. If this is because of out-of-date forks then perhaps the link checker should, for now, only be checking lines of delta?

@aduermael
Copy link
Contributor Author

@johndmulhausen please merge this one and ask authors to rebase: #1302

We fixed all broken links a few days ago, but then commits for 1.13 got merged without testing.

I'm improving our tests, also fixing a few of those links. (see #1301)
Hopefully that PR will be ready tomorrow or the day after.

@mdlinville
Copy link

I merged #1302. I'll rebase vnext-engine and vnext-compose to get it.

@aduermael
Copy link
Contributor Author

Thank you @mstanleyjones!

@johndmulhausen
Copy link

@aduermael I completely support what you're doing with the CI tests and look forward to the day when we can make them mandatory. But for now, you should expect that future PRs will be merged without testing until we have a Jenkins system that doesn't block PRs for days because of implementation issues, such as incompatibility with existing forks, tests not starting for days, tests not finishing for days, etc. Obviously, given those issues, we had to make the call to proceed with the 1.13 release without Jenkins tests, but I'm sure if we all work the issue we can put an end to the bypass. Sorry we have to turn off the test (#1302) for now; thank you for all your hard work!

@aduermael
Copy link
Contributor Author

@johndmulhausen I added timeouts: #1301 (15 minutes for checkout, 30 minutes for actual tests)

@aduermael
Copy link
Contributor Author

@johndmulhausen, @sanscontext, @joaofnfernandes, @mstanleyjones:

I created a spreadsheet based on output from #1301. Redirects don't generate errors anymore, if we fix all the red ones, checks will be successful:

https://docs.google.com/spreadsheets/d/1y_svpzGHNkZmuQJjzrTzq7TC0a72S-iuj7NDxo3dQXc/edit?usp=sharing

@aduermael
Copy link
Contributor Author

@johndmulhausen, @sanscontext, @joaofnfernandes, @mstanleyjones:

I updated the spreadsheet, I need your help now! :)
You can let comments for the ones that can't easily be solved.

https://docs.google.com/spreadsheets/d/1y_svpzGHNkZmuQJjzrTzq7TC0a72S-iuj7NDxo3dQXc/edit#gid=15989068

bermudezmt added a commit that referenced this issue May 22, 2019
* Service labels info

* Tuning info

* Update info

* New deploy landing page info

* Offline install info

* New production info

* New upgrade info

* New landing page info

* Canary info

* Context info

* Landing page info

* Interlock VIP mode info

* Labels reference info

* Redirects info

* Service clusters info

* Sessions info

* SSL info

* TLS info

* Websockets info

* Incorporated latest change from Netlify site

* Images

* Moved to images directory

* Moved info

* Moved info

* Moved info

* Moved info

* Moved info

* Changed default port based on github.io update

* Add HideInfoHeaders based on github.io update

* HideInfoHeaders in code sample

* Wording and tag updates

* Tag and link updates

* Fix some minor issues in vfs storage-driver section

- Fix mention of `storage-drivers` instead of `storage-opts`
- Repeat the selected driver in the second `daemon.json` example
- Remove mention of `CE` as this driver can be used
  on Docker EE (although it's mainly intending for
  debugging, so not a "supported" driver)

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Wording cleanup

* Intra-doc links

* Link titles

* Wording and link changes

* Remove site URL from link path

* Removed Kube GC Known issue from UCP 3.1.4

* Update release-notes.md

DTR info

Edits on 2.5.10 and 2.6.4 entries

Add upgrade warning information

Updated engine info per Andrew's input

Added Component table info per Mark

* Update DTR release notes

* Fixed dates

* Fixed formatting issues

* Temporary - review later

* Remove stage compose file for docs-private

* Update compose-version to 1.24.0

https://github.com/docker/compose/releases/tag/1.24.0

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* re-add removed Jenkinsfile

* Added moby#36951 to 18.09.4 release notes

* Wording and link updates

* Updated Offline Bundles for March Patch

* Update release notes for 1.23.2 and 1.24.0

Signed-off-by: Ulysses Souza <ulysses.souza@docker.com>

* Link to client bundle instructions

* Minor edits

- Moved dates to be consistent with other release notes
- Made grammar a little more consistent

* Update index.md : #### host or none - network (#8425)

* Update index.md : #### host or none - network

Choosing specific network for a build instead of the [network_mode]. network_mode doesn't work when providing a network for a particular build rather it skips the block and move to next service thus using network.

* Minor syntax updates

* Update index.md

those changes were a result of conflict that i tried to resolve.

* add slack webhook to Jenkinsfile

* add slack webhook to Jenkinsfile

* Update release-notes.md

* add slack webhook to Jenkinsfile

* Fix labels-reference link

* Add pip dependencies to compose doc for alpine (#8554)

* Add pip dependencies to compose doc for alpine

Signed-off-by: Ulysses Souza <ulysses.souza@docker.com>

* Minor edit

* Audit branch (#8564)

* Update trust-with-remote-ucp.md

* Fix link texts

* Addresses 8446

* Update trust_delegation.md

* - Addresses 8446
- Cleans up broken links
- Fixes vague link texts

Addresses 8446

Update trust_delegation.md

* Update running_ssh_service.md

* Update running_ssh_service.md

Fixed formatting and wording. Also moved note above the code.

* Update running_ssh_service.md

Fixed typo.

* Compose: Update build docs, Add --quiet flag

* Fix destroy reference page link

Relates to https://github.com/docker/docker.github.io/pull/8441

* Rephrase Ubuntu 14.04 note

* Revert "Compose: Update build docs, Add --quiet flag"

* # This is a combination of 4 commits.
# This is the 1st commit message:

- Addresses 8446
- Cleans up broken links
- Fixes vague link texts

Addresses 8446

Update trust_delegation.md

# This is the commit message #2:

# This is a combination of 2 commits.
# This is the 1st commit message:

- Addresses 8446
- Cleans up broken links
- Fixes vague link texts

Addresses 8446

Update trust_delegation.md

# This is the commit message #2:

Update trust-with-remote-ucp.md
# This is the commit message #3:

- Addresses 8446
- Cleans up broken links
- Fixes vague link texts

# This is the commit message #4:

Fix destroy reference page link

Relates to https://github.com/docker/docker.github.io/pull/8441

* - Addresses 8446
- Cleans up broken links
- Fixes vague link texts

* Addresses 8446 with text and link cleanup.

* Update syntax language from none to bash

* Update index.md

* Remove merge conflict

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Adding Azure note (#8566)

* Adding Azure note

* Rephrase additional line and update link

* Fix typo

* Update configs.md

* Adding Azure note (#8566)

* Adding Azure note

* Rephrase additional line and update link

* Final edit

* Updated the 3.1.4 release notes to include Centos 7.6 support

* update jenkinsfile with very important protections

So we're lucky we're not using the master branch to update our swarm services here because if we someone had pushed to it, it would have triggered a docs.docker.com build. This is becuase this Jenkinsfile, which has been merged from the docker.github.io project has the content for updating docs.docker.com and not beta.docs.docker.com. Maria and I have worked out a potential solution to this problem and I hope to implement it today.

* add protection to Jenkinsfile

* fix git url protection in jenkinsfile

* typo fix

friendlyname -> friendlyhello

* Storage backend data migration updates

Fix incorrect API command, add backup updates

Update incorrect commands

* --unmanaged-cni is not a valid option for upgrade

* Update to UCP known issues

* Update UCP release notes

* Update release-notes.md

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* Add HSTS warning for specifying --dtr-external-url

* Typo on logging driver name

* Addressed engineering feedback

* Netlify redirects interlock (#8595)

* Added netlify redirect

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Sync published with master (#8619)

* Update install.md

add note: 8 character password minimum length

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Updated the 3.1.4 release notes to include Centos 7.6 support

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Add the 'Install on Azure' page back to the TOC for UCP 3.0 (#8623)

* Add the Install on Azure page back to the UCP 3.0 TOC

* Fix the copy / paste error on Install on UCP

* Fix Liquid syntax error in "reset user password"

```
Liquid Warning: Liquid syntax error (line 33): Expected end_of_string but found number in "{{ index .Spec.TaskTemplate.ContainerSpec.Args 0 }}" in ee/ucp/authorization/reset-user-password.md
```

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Fix link text

* Patch release notes 04 2019 (#8633)

* Add version update for Engine/UCP

* Add DTR version updates

* Added April Offline Bundles

* Engine release notes update

* Update release-notes.md

* Update release-notes.md

* Minor edit

* Minor edit

* Add 2.4.11 DTR info

* Remove statement about supporting CNI plugin (#8594)

* Remove statement about supporting CNI plugin

* Update install-cni-plugin.md

* Removing internal JIRA links

* Use site parameter to use latest compose file versions in examples (#8630)

* Use site parameter to use latest compose file versions in examples

Make sure that examples use the latest version of the compose file
format, to encourage using the latest version, and to prevent
users from running into "not supported by this version" problems
when copy/pasting, and combining examples that use different
versions.

Also add a note about `version: x` not being equivalent to
`version: x.latest`.

Note that there are still some examples using fixed versions
in the UCP sections; we need to evaluate those to make sure
the right (and supported) versions are used for UCP (which may
be different than "latest").

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Address some v3/v2 issues, and YAML syntax error

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Minor edit

* Final updates

- Added note around v2 and v3 versioning
- Updated note for v3 to match the v2 update

* compose-file: remove reference to custom init path (#8628)

* compose-file: remove reference to custom init path

This option was never functional, and was not intended
to be added to the "container create" API, so let's
remove it, because it has been removed in Docker 17.05,
and was broken in versions before that; see

- docker/docker-py#2309 Remove init_path from create
- moby/moby#32355 --init-path does not seem to work
- moby/moby#32470 remove --init-path from client

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

* Update index.md

* Remove extra which

Change below line

From

AUFS, which can suffer noticeable latencies when searching for files in images with many layers

To

AUFS can suffer noticeable latencies when searching for files in images with many layers

* Fix a broken link

* Add documentation for --service-cluster-ip-range flag

https://github.com/docker/orca/pull/16417 adds support to make service cluster IP range subnet configurable for UCP install via the    --service-cluster-ip-range flag

* Added a period.

* Add documentation for UCP install page

Signed-off-by: Arko Dasgupta <arko.dasgupta@docker.com>

* Redirect to current version of page, since it's reached EOL

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Sync published with master (#8673)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Published (#8674)

* add slack webhook to Jenkinsfile

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* Sync published with master (#8619)

* Update install.md

add note: 8 character password minimum length

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Updated the 3.1.4 release notes to include Centos 7.6 support

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Sync published with master (#8673)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8678)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Fixed heading inconsistency

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8677)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Update concatenated to chained

* Minor fix

* interlock --> ucp-interlock (#8675)

* interlock --> ucp-interlock

* Fixed code samples 

- Use the latest UCP version and the latest ucp-interlock image
- Leverage ucp page version Jekyll variable

* Typo

* Final syntax fix

* Update backup.md

* Sync published with master (#8685)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Published (#8674)

* add slack webhook to Jenkinsfile

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* Sync published with master (#8619)

* Update install.md

add note: 8 character password minimum length

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Updated the 3.1.4 release notes to include Centos 7.6 support

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Sync published with master (#8673)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8678)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Fixed heading inconsistency

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8677)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Update concatenated to chained

* Minor fix

* interlock --> ucp-interlock (#8675)

* interlock --> ucp-interlock

* Fixed code samples 

- Use the latest UCP version and the latest ucp-interlock image
- Leverage ucp page version Jekyll variable

* Typo

* Final syntax fix

* Update backup.md

* Removed Reference to Interlock Preview Image, and added relevant UCP Image Org and Tag

* Fix syntax error which caused the master build to fail

* Preview page.ucp_org output

* Sync published with master (#8693) (#8694)

* Adding Azure note (#8566)

* Adding Azure note

* Rephrase additional line and update link

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Published (#8674)

* add slack webhook to Jenkinsfile

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* Sync published with master (#8619)

* Update install.md

add note: 8 character password minimum length

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Updated the 3.1.4 release notes to include Centos 7.6 support

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Sync published with master (#8673)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8678)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Fixed heading inconsistency

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8677)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Update concatenated to chained

* Minor fix

* interlock --> ucp-interlock (#8675)

* interlock --> ucp-interlock

* Fixed code samples 

- Use the latest UCP version and the latest ucp-interlock image
- Leverage ucp page version Jekyll variable

* Typo

* Final syntax fix

* Update backup.md

* Removed Reference to Interlock Preview Image, and added relevant UCP Image Org and Tag

* Fix syntax error which caused the master build to fail

* docs: fix typo in removal of named volumes (#8686)

* Updated the ToC for Upgrading Interlock

* Removed the Previous Interlock SSL Page

* Moved Redirect to latest page

* Update index.md (#8690)

Fix typo - missing word.

* Update bind-mounts.md (#8696)

* Minor edits (#8708)

* Minor edits

- Standardized setting of replica ID as per @caervs 
- Fix broken link

* Consistency edits

- Standardized setting of replica ID
- Added note that this command only works on Linux

* Standardize replica setting

- Update commands for creating tar files for local and NFS-mounted images

* Fixed broken 'important changes' link (#8721)

* Interlock fix - remove haproxy and custom template files (#8722)

* Removed haproxy and custom template info

* Delete file

* Delete file

* Render DTR version (#8726)

* Release notes for 2.0.4.0 win (Edge)

Signed-off-by: Mathieu Champlon <mathieu.champlon@docker.com>

* Release notes for 2.0.4.0 mac (Edge)

Signed-off-by: Mathieu Champlon <mathieu.champlon@docker.com>

* Update-edge-release-notes.md

Minor updates to the proposed content. Looks good otherwise.

* Updated edge-release-notes (Windows)

Minor edits

* Added Docker-Compose awslogs example (#8638)

* Added docker compose aws logs information

* Fixed formatting and text

- Signed off by @bermudezmt

* Fix: duplicate paragraph `depends_on` (#8539)

* Fix: duplicate paragraph `depends_on`

Amend duplicate paragraph `depends_on` in Compose file reference doc.

* Fix: add missing blank line

* Updated Engine/DTR/UCP version info (#8744)

* Updated Engine/DTR/UCP version info

* Fixed version

* Updates for May patch

* Release notes update (May) (#8763)

* Latest info including known issues

* Updates for 2.6.6, 2.5.11, 2.4.12

* Added 18.09.6 updates

* Added link

* Fixed link error

* Syntax error

* 2.6.6 info cleanup

* Added Hub info

* Added Hub info for 2.6.6

* Added Hub info for 3.1.7

* Link fix

* Update line items for DTR 2.6.6

* Add line break after Known Issues

- Affects 2.5.11.

* Edit line items

Minor edits and formatting fixes

* Remove outdated links/fix links (#8760)

* Fix dates

* Fix dates

* Fix dates

* Fixed syntax error (#8732)

* Fixed syntax error

Last edit to the REPLICA_ID command introduced a syntax error by adding an extra ')'. Removed it.

* Fix replica ID setting examples

- Accept suggestion from @thajeztah based on product testing
- Apply change to page examples
- Remove NFS backup example based on the following errors: 
tar: /var/lib/docker/volumes/dtr-registry-nfs-36e6bf87816d: Cannot stat: No such file or directory
tar: Exiting with failure status due to previous errors

* Update header for example tar

* Fixed link title

* Fixed link title

* Added new example and deprecation info (#8773)

* Updated multi-stage build doc (#8769)

Changed the 'as' keyword to 'AS' to match the Dockerfile reference docs here: https://docs.docker.com/engine/reference/builder/#from

* Fix typo (#8766)

* Fixed a sentence (#8728)

* Fixed a sentence

* Minor edit

* Update configure-tls.md (#8719)

* Update upgrade.md (#8718)

* Update index.md (#8717)

* Update configure-tls.md (#8716)

* Add TOC entry for Hub page title change (#8777)

* Update upgrade.md

* Fix left navigation TOC

* Update get-started.md (#8713)

* Update tmpfs.md (#8711)

* Add an indentation in compose-gettingstarted.md (#8487)

* Add an indentation

* Fix messaging on service dependencies

* Sync master with published (#8779)

* Sync published with master (#8693)

* Adding Azure note (#8566)

* Adding Azure note

* Rephrase additional line and update link

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Published (#8674)

* add slack webhook to Jenkinsfile

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* Sync published with master (#8619)

* Update install.md

add note: 8 character password minimum length

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Updated the 3.1.4 release notes to include Centos 7.6 support

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Sync published with master (#8673)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8678)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Fixed heading inconsistency

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8677)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Update concatenated to chained

* Minor fix

* interlock --> ucp-interlock (#8675)

* interlock --> ucp-interlock

* Fixed code samples 

- Use the latest UCP version and the latest ucp-interlock image
- Leverage ucp page version Jekyll variable

* Typo

* Final syntax fix

* Update backup.md

* Removed Reference to Interlock Preview Image, and added relevant UCP Image Org and Tag

* Fix syntax error which caused the master build to fail

* Sync published with master (#8695)

* Sync published with master (#8693) (#8694)

* Adding Azure note (#8566)

* Adding Azure note

* Rephrase additional line and update link

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Published (#8674)

* add slack webhook to Jenkinsfile

* make jenkinsfile serve private and public docs

After a couple of Jenkins-based mix-ups it became obvious we needed a Jenkinsfile that would serve both public and private projects, that we could move between repos without worry. This Jenkinsfile knows which images to build and push and which swarm services to update because of the use of git_url and branch conditions.

* Sync published with master (#8619)

* Update install.md

add note: 8 character password minimum length

* Include Ubuntu version in Dockerfile

more recent versions of Ubuntu don't work with the given Dockerfile

* Updated the 3.1.4 release notes to include Centos 7.6 support

* Remove redundant "be"

* Update the "role-based access control" link

On page "https://docs.docker.com/ee/ucp/user-access/", update the hyperlink "role-based access control" to point to "https://docs.docker.com/ee/ucp/authorization/" instead of "https://docs.docker.com/ee/access-control".

* Add UCP user password limitation

* Revert "Updated the UCP 3.1.4 release notes to include Centos 7.6 support"

* Adding emphasis on Static IP requirement (#7276)

* Adding emphasis on Static IP requirement

We had a customer (00056641) who changed IPs like this all at once, and they are in a messy status.    We should make it clear that static IP is absolutely required.  
```***-ucp-0-dw original="10.15.89.6" updated="10.15.89.7" 
***-ucp-1-dw original="10.15.89.5" updated="10.15.89.6" 
***-ucp-2-dw original="10.15.89.7" updated="10.15.89.5" ```

* Link to prod requirement of static IP addresses

* Adding warning about layer7 config (#8617)

* Adding warning about layer7 config

Adding warning about layer7 config not being included in the backup

* Text edit

* Sync published with master (#8673)

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Fix grammar on the 2nd pre-req, and did markdown formatting on the rest :)

* Correct Pod-CIDR Warning

* Content cleanup

Please check that I haven't changed the meaning of the updated prerequisites.

* Create a new section on configuring the IP Count value, also responded to feedback from Follis, Steve R and Xinfeng.

* Incorporated Steven F's feedback and Issue 8551

* Provide a warning when setting a small IP Count variable

* Final edits

* Update install-on-azure.md

* Following feedback I have expanded on the 0644 azure.json file permissions and Added the --existing-config file to the UCP install command

* Removed Orchestrator Tag Pre Req from Azure Docs

* Clarifying need for 0644 permissions

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image backup commands were invalid (incorrectly used -C flag). Replaced them with commands that work.
2. The new commands automatically populate the correct replica ID and add a datestamp to the backup filename.

DTR Metadata backup command improvements:

DTR metadata backups are more difficult than they need to be and generate many support tickets. I updated the DTR command to avoid common user pitfalls:

1. The prior metadata backup command was subject to user error. Improved the command to automatically collect the DTR version and select a replica. 
2. Improved security of the command by automatically collecting UCP CA certificate for verification rather than using --ucp-insecure-tls flag. 
3. Improved the backup filename by adding the backed-up version information and date of backup. Knowledge of the version information is required for restoring a backup.
4. Described these improvements for the user.

Image backup commands were tested with local and NFS image storage. The metadata backup command was tested by running it directly on a DTR node and through a UCP client bundle with multiple replicas.

* Technical and editorial review

* More edits

* line 8; remove unnecessary a (#8672)

* line 8; remove unnecessary a

* Minor edit

* Updated the UCP Logging page to include UCP 3.1 screenshots (#8646)

* Added examples (#8599)

* Added examples

Added examples with more detail and automation to help customers backup DTR without creating support tickets.

* Linked to explanation of example command

@omegamormegil I removed the example with prepopulated fields, as I think it doesn't add much, and will only add confusion. Users who need this much detail can run the basic command and follow the terminal prompts. 

We can re-add in a follow-up PR, if you think that example is crucial to this page.

* Remove deadlink in the Interlock ToC (#8668)

* Found a deadlink in the Interlock ToC

* Added Redirect

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8678)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Fixed heading inconsistency

* Trying to fix command rendering of '--format "{{ .Names }}"' (#8677)

* Trying to fix command rendering of '--format "{{ .Names }}"'

--format "{{ .Names }}" is showing up in the markup but is rendering as --format "" in the published version. Added {% raw %} tags to try to fix.

* Update concatenated to chained

* Minor fix

* interlock --> ucp-interlock (#8675)

* interlock --> ucp-interlock

* Fixed code samples 

- Use the latest UCP version and the latest ucp-interlock image
- Leverage ucp page version Jekyll variable

* Typo

* Final syntax fix

* Update backup.md

* Removed Reference to Interlock Preview Image, and added relevant UCP Image Org and Tag

* Fix syntax error which caused the master build to fail

* docs: fix typo in removal of named volumes (#8686)

* Sync published with master (#8709)

* Sync published with master (#8693) (#8694)

* Adding Azure note (#8566)

* Rephrase additional line and update link

* Revert "Netlify redirects interlock (#8595)"

This reverts commit a7793edc746fc3374f1b4a637bf4d528dd2bbcef.

* UCP Install on Azure Patch (#8522)

* Improved backup commands (#8597)

* Improved backup commands

DTR image backup command improvements:

1. Local and NFS mount image ba…
@docker-robott
Copy link
Collaborator

Closed issues are locked after 30 days of inactivity.
This helps our team focus on active issues.

If you have found a problem that seems similar to this, please open a new issue.

/lifecycle locked

@docker docker locked and limited conversation to collaborators Mar 5, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

6 participants