From 0e40388edab02b0fa036f00c9cf1eec40548bc33 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Fri, 2 Nov 2018 13:31:45 -0700 Subject: [PATCH 1/7] added autoproxy guide and adjusted organization of the guides page including removing maintenance.rst and network.rst as they are no longer needed. --- .../guides/clearlinux/autoproxy.rst | 18 ++++ .../guides/clearlinux/autoproxy_about.txt | 43 ++++++++++ .../guides/clearlinux/autoproxy_guide.txt | 77 ++++++++++++++++++ .../guides/clearlinux/figures/autoproxy_0.png | Bin 0 -> 24307 bytes source/clear-linux/guides/guides.rst | 29 ++++++- .../guides/maintenance/maintenance.rst | 28 ------- source/clear-linux/guides/network/network.rst | 16 ---- 7 files changed, 163 insertions(+), 48 deletions(-) create mode 100644 source/clear-linux/guides/clearlinux/autoproxy.rst create mode 100644 source/clear-linux/guides/clearlinux/autoproxy_about.txt create mode 100644 source/clear-linux/guides/clearlinux/autoproxy_guide.txt create mode 100644 source/clear-linux/guides/clearlinux/figures/autoproxy_0.png delete mode 100644 source/clear-linux/guides/maintenance/maintenance.rst delete mode 100644 source/clear-linux/guides/network/network.rst diff --git a/source/clear-linux/guides/clearlinux/autoproxy.rst b/source/clear-linux/guides/clearlinux/autoproxy.rst new file mode 100644 index 00000000..fe4c3987 --- /dev/null +++ b/source/clear-linux/guides/clearlinux/autoproxy.rst @@ -0,0 +1,18 @@ +.. _autoproxy: + +Autoproxy +######### + +.. rst-class:: html-toggle + +About +===== + +.. include:: autoproxy_about.txt + +.. rst-class:: html-toggle + +Guide +===== + +.. include:: autoproxy_guide.txt \ No newline at end of file diff --git a/source/clear-linux/guides/clearlinux/autoproxy_about.txt b/source/clear-linux/guides/clearlinux/autoproxy_about.txt new file mode 100644 index 00000000..80dcaa4e --- /dev/null +++ b/source/clear-linux/guides/clearlinux/autoproxy_about.txt @@ -0,0 +1,43 @@ +The |CL-ATTR| is the first Linux distribution to support autoproxy. The OS +can discover a Proxy Auto-Config (PAC) script and use it to automatically +resolve the proxy needed for a given connection. With Autoproxy, you can use +|CL| inside any proxy environment without having to manually +configure the proxies. + +Corporate and private networks can be very complex, needing to restrict and +control network connections for security reasons. The typical side effects +are limited or blocked connectivity and requiring manual configuration of +proxies to perform the most mundane tasks such as cloning a repo or checking +for updates. With Clear Linux, all of the work is done behind the scenes to +effortlessly use your network and have connections “just work”. + +This feature removes massive complications in network connectivity due to +proxy issues. You can automate tasks like unit testing without worrying +about the proxy not being set and you can remove unset proxies from the +equation when dealing with network unavailability across systems. + +How Autoproxy works +------------------- + +We designed autoproxy around general tools provided by nearly any Linux +distribution with a few minor additions and modifications. We leveraged the +DHCP and network information provided from systemd and created a +PAC-discovery daemon. The daemon uses the information to resolve a URL for a +PAC file. The daemon then passes the URL into PACrunner*. PACrunner +downloads the PAC file and uses the newly implemented Duktape* engine to +parse it. + +.. figure:: figures/autoproxy_0.png + :width: 400px + + Figure 1: Autoproxy Flow + +From that point on, any cURL* or network requests query PACrunner for the +correct proxy to use. We modified the cURL library to communicate with +PACrunner over DBus. However, cURL will ignore PACrunner and run normally if +no PAC file is loaded or if you set any proxies manually. Thus, your +environment settings are respected and no time is wasted trying to resolve a +proxy. + +More importantly: all these steps happen in the background, very quickly, and +with no user interaction. \ No newline at end of file diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt new file mode 100644 index 00000000..3422a747 --- /dev/null +++ b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt @@ -0,0 +1,77 @@ +Autoproxy allows |CL| to operate seamlessly behind a proxy +because, :ref:`swupd-guide` and other |CL| tools are implemented on +top of libcurl. Tools that do not use libcurl, like git, must +be configured independently. + +If you encounter problems with autoproxy functioning, use +:command:`pacdiscovery` and :command:`FindProxyForURL` to +help troubleshoot assuming a familiarity with PAC files and WPAD. + +.. note:: + + Learn more about WPAD, PAC files, and PAC functions at `findproxyforurl`_. + +.. _findproxyforurl: http://findproxyforurl.com/ + +Running :command:`pacdiscovery` with no arguments will immediately indicate + +1. if there is a problem resolving the :command:`WPAD` host name resolution: + + .. code:: console + + $ pacdiscovery + failed getaddrinfo: No address associated with hostname + Unable to find wpad host + +2. or if the :command:`pacrunner` service is disabled (masked). + + .. code:: console + + $ pacdiscovery + PAC url: http://autoproxy.your.domain.com/wpad.dat + Failed to create proxy config: Unit pacrunner.service is masked. + +Unmask the :command:`pacrunner` service by running: + +.. code:: console + + $ systemctl unmask pacrunner.service + +:command:`FindProxyForURL` with :command:`busctl` can also indicate if the +:command:`pacrunner.service` is masked. + +.. code:: console + + $ busctl call org.pacrunner /org/pacrunner/client org.pacrunner.Client FindProxyForURL ss "http://www.google.com" "google.com" + Unit pacrunner.service is masked. + dig wpad, dig wpad. + +:command:`FindProxyForURL` returns the URL and port of the proxy server when +an external URL and host are provided as arguments. + +.. code:: console + + $ busctl call org.pacrunner /org/pacrunner/client org.pacrunner.Client FindProxyForURL ss "http://www.google.com" "google.com" + s "PROXY proxy.your.domain.com:" + +If a proxy server is not avialable, or if :command:`pacrunner` is running +without a PAC file, :command:`FindProxyForURL` will return "DIRECT". + +.. code:: console + + $ busctl call org.pacrunner /org/pacrunner/client org.pacrunner.Client FindProxyForURL ss "http://www.google.com" "google.com" + s "DIRECT" + +Once :command:`pacdiscovery` is able to look up :command:`WPAD`, restart the +:command:`pacrunner` service: + +.. code:: console + + $ systemctl stop pacrunner + $ systemctl restart pacdiscovery + +.. note:: + + A "domain" or "search" entry in :file:`/etc/resolv.conf` is required for short + name lookups to resolve. The :file:`resolv.conf` man page has additional + details. \ No newline at end of file diff --git a/source/clear-linux/guides/clearlinux/figures/autoproxy_0.png b/source/clear-linux/guides/clearlinux/figures/autoproxy_0.png new file mode 100644 index 0000000000000000000000000000000000000000..7a02cd81f27692f24b8e30b672a95655d8bbae6e GIT binary patch literal 24307 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 DVa;3x literal 0 HcmV?d00001 diff --git a/source/clear-linux/guides/guides.rst b/source/clear-linux/guides/guides.rst index f2c65575..c4a308da 100644 --- a/source/clear-linux/guides/guides.rst +++ b/source/clear-linux/guides/guides.rst @@ -13,9 +13,30 @@ Our Guides: The following guides provide step-by-step instructions for tasks that come after completing the |CL| :ref:`installation `. -.. toctree:: - :maxdepth: 2 +Clear Linux Tooling +=================== - maintenance/maintenance - network/network +.. toctree:: + :maxdepth: 1 + :glob: + + clearlinux/* + +Maintenance +=========== + +.. toctree:: + :maxdepth: 1 + :glob: + + maintenance/* deploy-at-scale + +Network +======= + +.. toctree:: + :maxdepth: 1 + :glob: + + network/* \ No newline at end of file diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst deleted file mode 100644 index 712e3844..00000000 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ /dev/null @@ -1,28 +0,0 @@ -.. _maintenance: - -Maintenance guide -################# - -These guides provide step-by-step instructions for common tasks associated -with maintaining |CL-ATTR| after :ref:`installation ` is -completed. - -.. toctree:: - :maxdepth: 2 - - developer-workstation - swupd-search - enable-user-space - swupd-guide - bulk-provision - mixer - mixin - validate-signatures - telemetry-enable - time - hostname - increase-virtual-disk-size - download-verify-decompress-linux - download-verify-decompress-mac - download-verify-decompress-windows - autospec diff --git a/source/clear-linux/guides/network/network.rst b/source/clear-linux/guides/network/network.rst deleted file mode 100644 index 5df83dcb..00000000 --- a/source/clear-linux/guides/network/network.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _network: - -Network guide -############# - -This guide provides step-by-step instructions for common tasks associated with -the configuration, administration, and use of networks in the |CLOSIA|. - -.. toctree:: - :maxdepth: 1 - - ipxe-install - dpdk - network-bonding - custom-clear-container - vnc \ No newline at end of file From d009fbd3bdf83e1d54bc0ebe6975a052a050d34c Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 5 Nov 2018 11:11:14 -0800 Subject: [PATCH 2/7] changes based on reviewer comments --- .../clear-linux/guides/clearlinux/autoproxy_about.txt | 11 +++++------ .../clear-linux/guides/clearlinux/autoproxy_guide.txt | 9 +++++---- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/source/clear-linux/guides/clearlinux/autoproxy_about.txt b/source/clear-linux/guides/clearlinux/autoproxy_about.txt index 80dcaa4e..178f9dd6 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_about.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_about.txt @@ -4,18 +4,17 @@ resolve the proxy needed for a given connection. With Autoproxy, you can use |CL| inside any proxy environment without having to manually configure the proxies. +* Automate unit testing without worrying about the proxy not being set +* Remove unset proxies from the equation when dealing with network + unavailability across systems. + Corporate and private networks can be very complex, needing to restrict and control network connections for security reasons. The typical side effects are limited or blocked connectivity and requiring manual configuration of proxies to perform the most mundane tasks such as cloning a repo or checking -for updates. With Clear Linux, all of the work is done behind the scenes to +for updates. With |CL|, all of the work is done behind the scenes to effortlessly use your network and have connections “just work”. -This feature removes massive complications in network connectivity due to -proxy issues. You can automate tasks like unit testing without worrying -about the proxy not being set and you can remove unset proxies from the -equation when dealing with network unavailability across systems. - How Autoproxy works ------------------- diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt index 3422a747..74a82cce 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt @@ -1,10 +1,10 @@ Autoproxy allows |CL| to operate seamlessly behind a proxy -because, :ref:`swupd-guide` and other |CL| tools are implemented on +because :ref:`swupd-guide` and other |CL| tools are implemented on top of libcurl. Tools that do not use libcurl, like git, must be configured independently. If you encounter problems with autoproxy functioning, use -:command:`pacdiscovery` and :command:`FindProxyForURL` to +:command:`sudo pacdiscovery` and :command:`FindProxyForURL` to help troubleshoot assuming a familiarity with PAC files and WPAD. .. note:: @@ -54,8 +54,9 @@ an external URL and host are provided as arguments. $ busctl call org.pacrunner /org/pacrunner/client org.pacrunner.Client FindProxyForURL ss "http://www.google.com" "google.com" s "PROXY proxy.your.domain.com:" -If a proxy server is not avialable, or if :command:`pacrunner` is running -without a PAC file, :command:`FindProxyForURL` will return "DIRECT". +If a proxy server is not available, or if :command:`pacrunner` is running +without a PAC file, :command:`FindProxyForURL` will return "DIRECT". Otherwise, +it should return your local proxy settings as shown above. .. code:: console From 404ef3b18b0b78000e8b56e1ec40d11339fbc311 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 5 Nov 2018 19:58:46 -0800 Subject: [PATCH 3/7] fixed a few small issues. --- source/clear-linux/guides/clearlinux/autoproxy_about.txt | 2 +- source/clear-linux/guides/clearlinux/autoproxy_guide.txt | 4 ++-- source/clear-linux/guides/guides.rst | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/source/clear-linux/guides/clearlinux/autoproxy_about.txt b/source/clear-linux/guides/clearlinux/autoproxy_about.txt index 178f9dd6..10f29816 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_about.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_about.txt @@ -2,7 +2,7 @@ The |CL-ATTR| is the first Linux distribution to support autoproxy. The OS can discover a Proxy Auto-Config (PAC) script and use it to automatically resolve the proxy needed for a given connection. With Autoproxy, you can use |CL| inside any proxy environment without having to manually -configure the proxies. +configure the proxies: * Automate unit testing without worrying about the proxy not being set * Remove unset proxies from the equation when dealing with network diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt index 74a82cce..70c0148d 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt @@ -1,6 +1,6 @@ Autoproxy allows |CL| to operate seamlessly behind a proxy -because :ref:`swupd-guide` and other |CL| tools are implemented on -top of libcurl. Tools that do not use libcurl, like git, must +because :ref:`software update ` and other |CL| tools are +implemented on top of libcurl. Tools that do not use libcurl, like git, must be configured independently. If you encounter problems with autoproxy functioning, use diff --git a/source/clear-linux/guides/guides.rst b/source/clear-linux/guides/guides.rst index c4a308da..dece5da5 100644 --- a/source/clear-linux/guides/guides.rst +++ b/source/clear-linux/guides/guides.rst @@ -11,7 +11,7 @@ Our Guides: The following guides provide step-by-step instructions for tasks that come -after completing the |CL| :ref:`installation `. +after completing the |CL-ATTR| :ref:`installation `. Clear Linux Tooling =================== From 4180c349026ee0e069d38d95fb4cdf006e5d00d6 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 6 Nov 2018 10:10:34 -0800 Subject: [PATCH 4/7] small refinement based on review feedback --- source/clear-linux/guides/clearlinux/autoproxy_guide.txt | 5 +++-- source/clear-linux/guides/guides.rst | 4 ++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt index 70c0148d..ca4f64b8 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_guide.txt @@ -14,8 +14,9 @@ help troubleshoot assuming a familiarity with PAC files and WPAD. .. _findproxyforurl: http://findproxyforurl.com/ Running :command:`pacdiscovery` with no arguments will immediately indicate +one of the following: -1. if there is a problem resolving the :command:`WPAD` host name resolution: +1. If there is a problem resolving the :command:`WPAD` host name resolution: .. code:: console @@ -23,7 +24,7 @@ Running :command:`pacdiscovery` with no arguments will immediately indicate failed getaddrinfo: No address associated with hostname Unable to find wpad host -2. or if the :command:`pacrunner` service is disabled (masked). +2. Or if the :command:`pacrunner` service is disabled (masked): .. code:: console diff --git a/source/clear-linux/guides/guides.rst b/source/clear-linux/guides/guides.rst index dece5da5..8bbd085e 100644 --- a/source/clear-linux/guides/guides.rst +++ b/source/clear-linux/guides/guides.rst @@ -5,13 +5,13 @@ Guides Our Guides: -* Provide a critical, fundamental understanding of |CL| features +* Provide a critical, fundamental understanding of |CL-ATTR| features * Show you how to leverage the full feature set of |CL| * Enhance your productivity when using |CL| The following guides provide step-by-step instructions for tasks that come -after completing the |CL-ATTR| :ref:`installation `. +after completing the |CL| :ref:`installation `. Clear Linux Tooling =================== From a5c93dbc693eb8183bba173f39ac3956c37d9525 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Fri, 2 Nov 2018 13:31:45 -0700 Subject: [PATCH 5/7] added autoproxy guide and adjusted organization of the guides page including removing maintenance.rst and network.rst as they are no longer needed. --- source/clear-linux/guides/clearlinux/autoproxy.rst | 4 ++-- .../{autoproxy_about.txt => autoproxy_about.rst.txt} | 0 .../{autoproxy_guide.txt => autoproxy_guide.rst.txt} | 0 3 files changed, 2 insertions(+), 2 deletions(-) rename source/clear-linux/guides/clearlinux/{autoproxy_about.txt => autoproxy_about.rst.txt} (100%) rename source/clear-linux/guides/clearlinux/{autoproxy_guide.txt => autoproxy_guide.rst.txt} (100%) diff --git a/source/clear-linux/guides/clearlinux/autoproxy.rst b/source/clear-linux/guides/clearlinux/autoproxy.rst index fe4c3987..eb9c7301 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy.rst +++ b/source/clear-linux/guides/clearlinux/autoproxy.rst @@ -8,11 +8,11 @@ Autoproxy About ===== -.. include:: autoproxy_about.txt +.. include:: autoproxy_about.rst.txt .. rst-class:: html-toggle Guide ===== -.. include:: autoproxy_guide.txt \ No newline at end of file +.. include:: autoproxy_guide.rst.txt diff --git a/source/clear-linux/guides/clearlinux/autoproxy_about.txt b/source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt similarity index 100% rename from source/clear-linux/guides/clearlinux/autoproxy_about.txt rename to source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt similarity index 100% rename from source/clear-linux/guides/clearlinux/autoproxy_guide.txt rename to source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt From 09c0a66193d62d432b0a0ffa3b8058885f7e3787 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Fri, 9 Nov 2018 16:20:35 -0800 Subject: [PATCH 6/7] changed extensions of rst includes to .rst.txt to match new scheme --- source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt | 4 ++++ source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt | 5 +++++ 2 files changed, 9 insertions(+) diff --git a/source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt b/source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt index 10f29816..c74a381a 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_about.rst.txt @@ -4,6 +4,10 @@ resolve the proxy needed for a given connection. With Autoproxy, you can use |CL| inside any proxy environment without having to manually configure the proxies: +* Automate unit testing without worrying about the proxy not being set +* Remove unset proxies from the equation when dealing with network + unavailability across systems. + * Automate unit testing without worrying about the proxy not being set * Remove unset proxies from the equation when dealing with network unavailability across systems. diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt index ca4f64b8..b02e3fb5 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt @@ -1,6 +1,11 @@ Autoproxy allows |CL| to operate seamlessly behind a proxy +<<<<<<< a5c93dbc693eb8183bba173f39ac3956c37d9525:source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt because :ref:`software update ` and other |CL| tools are implemented on top of libcurl. Tools that do not use libcurl, like git, must +======= +because :ref:`swupd-guide` and other |CL| tools are implemented on +top of libcurl. Tools that do not use libcurl, like git, must +>>>>>>> changes based on reviewer comments:source/clear-linux/guides/clearlinux/autoproxy_guide.txt be configured independently. If you encounter problems with autoproxy functioning, use From a58b36117dc59b3eec8d5404ff6cd48b78245960 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Fri, 9 Nov 2018 16:45:58 -0800 Subject: [PATCH 7/7] fixed dangling reviewer comment --- source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt b/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt index b02e3fb5..ca4f64b8 100644 --- a/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt +++ b/source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt @@ -1,11 +1,6 @@ Autoproxy allows |CL| to operate seamlessly behind a proxy -<<<<<<< a5c93dbc693eb8183bba173f39ac3956c37d9525:source/clear-linux/guides/clearlinux/autoproxy_guide.rst.txt because :ref:`software update ` and other |CL| tools are implemented on top of libcurl. Tools that do not use libcurl, like git, must -======= -because :ref:`swupd-guide` and other |CL| tools are implemented on -top of libcurl. Tools that do not use libcurl, like git, must ->>>>>>> changes based on reviewer comments:source/clear-linux/guides/clearlinux/autoproxy_guide.txt be configured independently. If you encounter problems with autoproxy functioning, use