summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJoshua Powers <josh.powers@canonical.com>2019-12-06 15:25:43 -0800
committerJoshua Powers <josh.powers@canonical.com>2019-12-06 15:25:43 -0800
commitade2bc3d6be9dcd766bc514a0731389d226fc6e0 (patch)
treee2257f502823bf48a95386f105b46aef4bd9ad0e /doc
parent9ae15a631e12daa9f35ae55431616b8e78c82651 (diff)
downloadvyos-cloud-init-ade2bc3d6be9dcd766bc514a0731389d226fc6e0.tar.gz
vyos-cloud-init-ade2bc3d6be9dcd766bc514a0731389d226fc6e0.zip
docs: Add document on how to report bugs
Diffstat (limited to 'doc')
-rw-r--r--doc/rtd/index.rst1
-rw-r--r--doc/rtd/topics/bugs.rst95
2 files changed, 96 insertions, 0 deletions
diff --git a/doc/rtd/index.rst b/doc/rtd/index.rst
index d2662edf..5d90c131 100644
--- a/doc/rtd/index.rst
+++ b/doc/rtd/index.rst
@@ -40,6 +40,7 @@ Having trouble? We would like to help!
topics/boot.rst
topics/cli.rst
topics/faq.rst
+ topics/bugs.rst
.. toctree::
:hidden:
diff --git a/doc/rtd/topics/bugs.rst b/doc/rtd/topics/bugs.rst
new file mode 100644
index 00000000..f9d9bc86
--- /dev/null
+++ b/doc/rtd/topics/bugs.rst
@@ -0,0 +1,95 @@
+.. _reporting_bugs:
+
+Reporting Bugs
+**************
+
+Logs
+====
+
+To aid in debugging collecting the necessary logs, first run the
+`collect-logs` subcommand to produce a tarfile that you can easily upload
+to aid in intial debugging of your issue:
+
+.. code-block:: shell-session
+
+ $ cloud-init collect-logs
+ Wrote /home/ubuntu/cloud-init.tar.gz
+
+If your cloud-init does not have the `collect-logs` subcommand, then please
+manually collect the base log files by doing the following:
+
+.. code-block:: shell-session
+
+ $ dmesg > dmesg.txt
+ $ sudo journalctl -o short-precise > journal.txt
+ $ sudo tar -cvf cloud-init.tar dmesg.txt journal.txt /run/cloud-init \
+ /var/log/cloud-init.log /var/log/cloud-init-output.log
+
+Reporting
+=========
+
+Bugs for upstream cloud-init are tracked using Launchpad. To file a bug,
+`create a Launchpad account`_, login, and then
+`report an upstream cloud-init bug`_.
+
+If your bug is for a specific distro using cloud-init, please first consider
+reporting it with the upstream distro or confirm that it still occurs
+with the latest upstream cloud-init code. See below for details on specific
+distro reporting.
+
+Distro Specific Issues
+======================
+
+For issues specific to your distro please use one of the following distro
+specific reporting mechanisms:
+
+Ubuntu
+------
+
+To report a bug on Ubuntu use the `ubuntu-bug` command to automatically
+collect the necessary logs and file a bug on Launchpad:
+
+.. code-block:: shell-session
+
+ $ ubuntu-bug cloud-init
+
+If that does not work or is not an option, please collect the logs using the
+commands above and then report the bug on the `Ubuntu bug tracker`_. Make sure
+to attach your collected logs!
+
+Debian
+------
+
+To file a bug against the Debian package fo cloud-init please use the
+`Debian bug tracker`_ to file against 'Package: cloud-init'. See the
+`Debian bug reporting wiki`_ wiki page for more details.
+
+Red Hat, CentOS, & Fedora
+-------------------------
+
+To file a bug against the Red Hat or Fedora packages of cloud-init please use
+the `Red Hat bugzilla`_.
+
+SUSE & openSUSE
+---------------
+
+To file a bug against the SuSE packages of cloud-init please use the
+`SUSE bugzilla`_.
+
+Arch
+----
+
+To file a bug against the Arch package of cloud-init please use the
+`Arch bugs`_. See the `Arch bug reporting wiki`_ for more details.
+
+.. _create a Launchpad account: https://help.launchpad.net/YourAccount/NewAccount
+.. _report an upstream cloud-init bug: https://bugs.launchpad.net/cloud-init/+filebug
+.. _Ubuntu bug tracker: https://bugs.launchpad.net/ubuntu/+source/cloud-init/+filebug
+.. _Debian bug tracker: https://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=cloud-init;dist=unstable
+.. _Debian bug reporting wiki: https://www.debian.org/Bugs/Reporting
+.. _Red Hat bugzilla: https://bugzilla.redhat.com/
+.. _SUSE bugzilla: https://bugzilla.suse.com/index.cgi
+.. _Arch bugs: https://bugs.archlinux.org/
+.. _Arch bug reporting wiki: https://wiki.archlinux.org/index.php/Bug_reporting_guidelines
+
+.. vi: textwidth=79