Repository structure doc updates

README.md

@@ -60,8 +60,12 @@ questions or comments.
 
   * pkg/backend: RP backend workers.
 
+  * pkg/bootstraplogging: Bootstrap logging configuration
+
   * pkg/client: Autogenerated ARO service Go client.
 
+  * pkg/cluster: Cluster create/update/delete operations wrapper for OCP installer.
+
   * pkg/database: RP CosmosDB wrapper layer.
 
   * pkg/deploy: /deploy ARM template generation code.
@@ -71,10 +75,6 @@ questions or comments.
 
   * pkg/frontend: RP frontend webserver.
 
-  * pkg/genevalogging: Daemonset for Geneva logging.
-
-  * pkg/install: OpenShift installer wrapper layer.
-
   * pkg/metrics: Handles RP metrics via statsd.
 
   * pkg/mirror: OpenShift release mirror tooling.
@@ -89,23 +89,40 @@ questions or comments.
       aro-operator-master.openshift-azure-operator:8080, to avoid the
       `AlertmanagerReceiversNotConfigured` warning.
 
-    * checker: Watches the `Cluster` resource for changes and perform a set of
-      checks for outbound internet connectivity.
+    * checker: Watches the `Cluster` resource for changes and updates conditions
+      of the resource based on checks mentioned below
+
+      * internetchecker: validate outbound internet connectivity to the nodes
+
+      * machinechecker: validate machine objects have the correct provider spec,
+        vm type, vm image, disk size, three master nodes exist, and the number of worker nodes
+        match the desired worker replicas
+
+    * dnsmasq: Ensures that a dnsmasq systemd service is defined as a machineconfig for all
+      nodes to allow for api-int and *.apps domains resolve even if custom DNS on the VNET is set.
 
     * genevalogging: Ensures all the Geneva logging resources in the
       `openshift-azure-logging` namespace matches the pre-defined specification
       found in `pkg/operator/controllers/genevalogging/genevalogging.go`.
 
+    * monitoring: Ensures that the OpenShift monitoring configuration in the `openshift-monitoring` namespace is consistent and immutable.
+
+    * node: Force deletes pods when a node fails to drain for 1 hour.  It should clear up any pods that refuse to be evicted on a drain due to violating a pod disruption budget.
+
     * pullsecret: Ensures that the ACR credentials in the
       `openshift-config/pull-secret` secret match those in the
       `openshift/azure-operator/cluster` secret.
 
-    * workaround: Applies a set of temporay workarounds to the ARO cluster.
+    * rbac: Ensures that the `aro-sre` clusterrole and clusterrolebinding exist and are consistent.
 
     * routefix: Ensures all the routefix resources in the namespace
       `openshift-azure-routefix` remain on the cluster.
 
-    * monitoring: Ensures Prometheus is configured to persist data.
+    * workaround: Applies a set of temporay workarounds to the ARO cluster.
+
+  * pkg/portal: Portal for running promql queries against a cluster or requesting a kubeconfig for a cluster.
+
+  * pkg/proxy: Proxy service for portal kubeconfig cluster access.
 
   * pkg/swagger: Swagger specification generation code.
 

docs/deploy-development-rp.md

@@ -19,6 +19,8 @@
    OSX users: please follow [Prepare your development environment using
    OSX](./prepare-your-development-environment-using-osx.md).
 
+   > __NOTE:__ The `gpgme-devel` and `libassuan-devel` libraries are needed in the aro `mirror` functionality.  The dependency can be excluded if one uses build tag `containers_image_openpgp` when building the RP.  See [this link](https://github.com/containers/image#supported-build-tags) for more details on removal.
+
 1. Install the [az
    client](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli), if you
    haven't already. You will need `az` version 2.0.72 or greater, as this

docs/upstream-differences.md

@@ -33,3 +33,5 @@ See https://github.com/openshift/installer/compare/release-4.6...jim-minter:rele
 
 * ARO deploys a private link service in order for the RP to be able to
   communicate with the cluster.
+
+* ARO runs a dnsmasq service on the nodes through the use of a machineconfig to resolve api-int and *.apps domains on the node locally allowing for custom DNS configured on the VNET.