From 96499001b977e4010c7790100a223c722bb7d2b6 Mon Sep 17 00:00:00 2001
From: bmcelvee <bmcelvee@redhat.com>
Date: Thu, 10 Jan 2019 10:19:06 -0500
Subject: [PATCH] Add build troubleshooting module

---
 _topic_map.yml                                |  2 ++
 builds/troubleshooting-builds.adoc            | 13 +++++++++++
 ...ilds-troubleshooting-access-resources.adoc | 23 +++++++++++++++++++
 3 files changed, 38 insertions(+)
 create mode 100644 builds/troubleshooting-builds.adoc
 create mode 100644 modules/builds-troubleshooting-access-resources.adoc

diff --git a/_topic_map.yml b/_topic_map.yml
index f4951b6e3013..dc6c16320b7f 100644
--- a/_topic_map.yml
+++ b/_topic_map.yml
@@ -45,6 +45,8 @@ Topics:
   File: basic-build-operations
 - Name: Triggering and modifying builds
   File: triggering-builds-build-hooks
+- Name: Troubleshooting builds
+  File: troubleshooting-builds
 ---
 Name: OpenShift CCS modular docs guide
 Dir: mod_docs_guide
diff --git a/builds/troubleshooting-builds.adoc b/builds/troubleshooting-builds.adoc
new file mode 100644
index 000000000000..ac2c76f52cba
--- /dev/null
+++ b/builds/troubleshooting-builds.adoc
@@ -0,0 +1,13 @@
+// This assembly is included in the following assemblies:
+// * assembly/builds
+
+
+:context: troubleshooting-builds
+[id='troubleshooting-builds_{context}']
+= Troubleshooting builds
+include::modules/common-attributes.adoc[]
+toc::[]
+
+Use the following to troubleshoot build issues.
+
+include::modules/builds-troubleshooting-access-resources.adoc[leveloffset=+1]
diff --git a/modules/builds-troubleshooting-access-resources.adoc b/modules/builds-troubleshooting-access-resources.adoc
new file mode 100644
index 000000000000..bb4991f86037
--- /dev/null
+++ b/modules/builds-troubleshooting-access-resources.adoc
@@ -0,0 +1,23 @@
+// Module included in the following assemblies:
+//
+// * assembly/builds
+
+[id='builds-troubleshooting-access-resources-{context}']
+= Resolving denial for access to resources
+
+If your request for access to resources is denied:
+
+Issue::
+A build fails with:
+
+----
+requested access to the resource is denied
+----
+
+Resolution::
+You have exceeded one of the image quotas set on your project. Check your
+current quota and verify the limits applied and storage in use:
+
+----
+$ oc describe quota
+----