Jelajahi Sumber

Moving "common setup issues" to separate page

Marcus Christie 8 tahun lalu
induk
melakukan
df6448b6b0
3 mengubah file dengan 23 tambahan dan 22 penghapusan
  1. 0 22
      docs/getting_started.rst
  2. 22 0
      docs/topics/common_setup_issues.rst
  3. 1 0
      docs/topics/overview.rst

+ 0 - 22
docs/getting_started.rst

@@ -12,28 +12,6 @@ run::
 
     pip install --upgrade cloudbridge
 
-Common Setup Issues
--------------------
-
-**macOS Issues**
-
-* If you are getting an error message like so: ``Authentication with cloud provider failed: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:749)``
-  then this indicates that you are probably using a newer version of Python on
-  macOS. Starting with Python 3.6, the Python installer includes its own version
-  of OpenSSL and it no longer uses the system trusted certificate keychains.
-
-  Python 3.6 includes a script that can install a bundle of root certificates
-  from ``certifi``.  To install this bundle execute the following:
-
-  .. code-block:: bash
-
-    cd /Applications/Python\ 3.6/
-    sudo ./Install\ Certificates.command
-
-  For more information see `this StackOverflow
-  answer <https://stackoverflow.com/a/42583411/1419499>`_ and the `Python 3.6
-  Release Notes <https://www.python.org/downloads/release/python-360/>`_.
-
 Create a provider
 -----------------
 To start, you will need to create a reference to a provider object. The

+ 22 - 0
docs/topics/common_setup_issues.rst

@@ -0,0 +1,22 @@
+Common Setup Issues
+===================
+
+macOS Issues
+------------
+
+* If you are getting an error message like so: ``Authentication with cloud provider failed: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:749)``
+  then this indicates that you are probably using a newer version of Python on
+  macOS. Starting with Python 3.6, the Python installer includes its own version
+  of OpenSSL and it no longer uses the system trusted certificate keychains.
+
+  Python 3.6 includes a script that can install a bundle of root certificates
+  from ``certifi``.  To install this bundle execute the following:
+
+  .. code-block:: bash
+
+    cd /Applications/Python\ 3.6/
+    sudo ./Install\ Certificates.command
+
+  For more information see `this StackOverflow
+  answer <https://stackoverflow.com/a/42583411/1419499>`_ and the `Python 3.6
+  Release Notes <https://www.python.org/downloads/release/python-360/>`_.

+ 1 - 0
docs/topics/overview.rst

@@ -12,4 +12,5 @@ Introductions to all the key parts of CloudBridge you'll need to know:
     Object states and lifecycles <object_lifecycles.rst>
     Paging and iteration <paging_and_iteration.rst>
     Using block storage <block_storage.rst>
+    Common setup issues <common_setup_issues.rst>