_build_cfg.yml

# This configuration file dictates the organization of the topic groups and
# topics on the main page of the doc site for this branch. Each record
# consists of the following:
#
# ---                                  <= Record delimiter
# Name: Origin of the Species          <= Display name of topic group
# Dir:  origin_of_the_species          <= Directory name of topic group
# Topics:
#   - Name: The Majestic Marmoset      <= Topic name
#     File: the_majestic_marmoset      <= Topic file under group dir +/- .adoc
#   - Name: The Curious Crocodile      <= Topic 2 name
#     File: the_curious_crocodile      <= Topic 2 file
#   - Name: The Numerous Nematodes     <= Sub-topic group name
#     Dir: the_numerous_nematodes      <= Sub-topic group dir
#     Topics:
#       - Name: The Wily Worm          <= Sub-topic name
#         File: the_wily_worm          <= Sub-topic file under <group dir>/<subtopic dir>
#       - Name: The Acrobatic Ascarid  <= Sub-topic 2 name
#         File: the_acrobatic_ascarid  <= Sub-topic 2 file under <group dir>/<subtopic dir>
#
# The ordering of the records in this document determines the ordering of the
# topic groups and topics on the main page.
---
Name: About
Dir: welcome
Distros: openshift-*
Topics:
  - Name: Welcome
    File: index
  - Name: All Revision History
    File: revhistory_all
    Distros: openshift-enterprise,openshift-dedicated

---
Name: Release Notes
Dir: release_notes
Distros: openshift-enterprise,openshift-dedicated
Topics:
  - Name: Overview
    File: index
  - Name: OpenShift Enterprise 3.2 Release Notes
    File: ose_3_2_release_notes
    Distros: openshift-enterprise
  - Name: OpenShift Dedicated 3.2 Release Notes
    File: osd_3_2_release_notes
    Distros: openshift-dedicated
  - Name: Developer Preview Release Notes
    File: online_release_notes
    Distros: openshift-online
  - Name: xPaaS Release Notes
    File: xpaas_release_notes
    Distros: openshift-enterprise
  - Name: Comparing OpenShift Enterprise 2 and OpenShift Enterprise 3
    File: v2_vs_v3
    Distros: openshift-enterprise,openshift-dedicated,openshift-online
  - Name: Revision History
    File: revhistory_release_notes

---
Name: What's New?
Dir: whats_new
Distros: openshift-origin
Topics:
  - Name: Overview
    File: index
  - Name: Release Notes
    File: ose_3_0_release_notes
    Distros: openshift-enterprise
  - Name: Applications
    File: applications
  - Name: Cartridges vs Images
    File: carts_vs_images
  - Name: Terminology
    File: terminology

---
Name: Getting Started
Dir: getting_started
Distros: openshift-*
Topics:
  - Name: Overview
    File: index
  - Name: Basic Walkthrough
    File: basic_walkthrough
    Distros: openshift-online
  - Name: Beyond the Basics
    File: beyond_the_basics
    Distros: openshift-online
  - Name: Web Console Walkthrough
    File: developers_console
    Distros: openshift-enterprise,openshift-dedicated,openshift-origin
  - Name: Setting Up a Cluster
    File: administrators
    Distros: openshift-origin,openshift-enterprise
  - Name: Developer Preview FAQ
    File: devpreview_faq
    Distros: openshift-online
  - Name: Comparing OpenShift 2 and 3
    File: online_v2_vs_v3
    Distros: openshift-online
  - Name: Revision History
    File: revhistory_getting_started
    Distros: openshift-enterprise,openshift-dedicated
---
Name: Quickstart
Dir: registry_quickstart
Distros: atomic-registry
Topics:
  - Name: Overview
    File: index
  - Name: Developers
    File: developers
  - Name: Administrators
    Dir: administrators
    Topics:
      - Name: Overview
        File: index
      - Name: System Configuration
        File: system_configuration
      - Name: Command Line Interface (CLI)
        File: cli
      - Name: Uninstall
        File: uninstall

---
Name: Architecture
Dir: architecture
Topics:
  - Name: Overview
    File: index
  - Name: Infrastructure Components
    Dir: infrastructure_components
    Topics:
      - Name: Kubernetes Infrastructure
        File: kubernetes_infrastructure
      - Name: Image Registry
        File: image_registry
      - Name: Web Console
        File: web_console
  - Name: Core Concepts
    Dir: core_concepts
    Topics:
      - Name: Overview
        File: index
        Distros: openshift-*
      - Name: Containers and Images
        File: containers_and_images
        Distros: openshift-*
      - Name: Images
        File: containers_and_images
        Distros: atomic-*
      - Name: Pods and Services
        File: pods_and_services
        Distros: openshift-*
      - Name: Projects and Users
        File: projects_and_users
      - Name: Builds and Image Streams
        File: builds_and_image_streams
        Distros: openshift-*
      - Name: Image Streams
        File: builds_and_image_streams
        Distros: atomic-*
      - Name: Deployments
        File: deployments
        Distros: openshift-*
      - Name: Routes
        File: routes
        Distros: openshift-*
      - Name: Templates
        File: templates
        Distros: openshift-*
  - Name: Additional Concepts
    Dir: additional_concepts
    Topics:
      - Name: Networking
        File: networking
        Distros: openshift-*
      - Name: OpenShift SDN
        File: sdn
        Distros: openshift-*
      - Name: Authentication
        File: authentication
      - Name: Authorization
        File: authorization
      - Name: Persistent Storage
        File: storage
        Distros: openshift-*
      - Name: Remote Commands
        File: remote_commands
        Distros: openshift-*
      - Name: Port Forwarding
        File: port_forwarding
        Distros: openshift-*
      - Name: Throttling
        File: throttling
        Distros: openshift-*
      - Name: Source Control Management
        File: scm
        Distros: openshift-*
      - Name: Admission Controllers
        File: admission_controllers
        Distros: openshift-enterprise,openshift-origin,openshift-dedicated
      - Name: Other API Objects
        File: other_api_objects
  - Name: Revision History
    File: revhistory_architecture
    Distros: openshift-enterprise,openshift-dedicated

---
Name: Installation and Configuration
Dir: install_config
Distros: openshift-origin,openshift-enterprise,atomic-*
Topics:
  - Name: Overview
    File: index
  - Name: Installing
    Dir: install
    Topics:
      - Name: Overview
        File: index
      - Name: Prerequisites
        File: prerequisites
      - Name: RPM vs Containerized
        File: rpm_vs_containerized
        Distros: openshift-origin,openshift-enterprise
      - Name: Quick Installation
        File: quick_install
        Distros: openshift-origin,openshift-enterprise
      - Name: Advanced Installation
        File: advanced_install
        Distros: openshift-origin,openshift-enterprise
      - Name: Disconnected Installation
        File: disconnected_install
        Distros: openshift-enterprise
      - Name: Deploying a Docker Registry
        File: docker_registry
      - Name: Deploying a Router
        File: deploy_router
        Distros: openshift-origin,openshift-enterprise
  - Name: Upgrading
    Dir: upgrading
    Distros: openshift-origin,openshift-enterprise
    Topics:
      - Name: Overview
        File: index
      - Name: Automated Upgrades
        File: automated_upgrades
      - Name: Manual Upgrades
        File: manual_upgrades
  - Name: Downgrading
    File: downgrade
    Distros: openshift-enterprise
  - Name: Master and Node Configuration
    File: master_node_configuration
    Distros: openshift-origin,openshift-enterprise
  - Name: Loading the Default Image Streams and Templates
    File: imagestreams_templates
    Distros: openshift-origin,openshift-enterprise
  - Name: Configuring Custom Certificates
    File: certificate_customization
  - Name: Configuring Authentication
    File: configuring_authentication
  - Name: Syncing Groups With LDAP
    File: syncing_groups_with_ldap
  - Name: Configuring the SDN
    File: configuring_sdn
    Distros: openshift-origin,openshift-enterprise
  - Name: Configuring for AWS
    File: configuring_aws
    Distros: openshift-origin,openshift-enterprise
  - Name: Configuring for OpenStack
    File: configuring_openstack
    Distros: openshift-origin,openshift-enterprise
  - Name: Configuring for GCE
    File: configuring_gce
    Distros: openshift-origin,openshift-enterprise
  - Name: Configuring Persistent Storage
    Dir: persistent_storage
    Distros: openshift-origin,openshift-enterprise
    Topics:
      - Name: Overview
        File: index
      - Name: Using NFS
        File: persistent_storage_nfs
      - Name: Using GlusterFS
        File: persistent_storage_glusterfs
      - Name: Using OpenStack Cinder
        File: persistent_storage_cinder
      - Name: Using Ceph RBD
        File: persistent_storage_ceph_rbd
      - Name: Using AWS Elastic Block Store
        File: persistent_storage_aws
      - Name: Using GCE Persistent Disk
        File: persistent_storage_gce
      - Name: Using iSCSI
        File: persistent_storage_iscsi
      - Name: Using Fibre Channel
        File: persistent_storage_fibre_channel
      - Name: Dynamic Provisioning
        File: dynamically_provisioning_pvs
      - Name: Volume Security
        File: pod_security_context
  - Name: Persistent Storage Examples
    Dir: storage_examples
    Distros: openshift-origin,openshift-enterprise
    Topics:
      - Name: Overview
        File: index
      - Name: Sharing an NFS PV Across Two Pods
        File: shared_storage
      - Name: Complete Example Using Ceph RBD
        File: ceph_example
      - Name: Complete Example Using GlusterFS
        File: gluster_example
      - Name: Mounting Volumes To Privileged Pods
        File: privileged_pod_storage
      - Name: Backing Docker Registry with GlusterFS Storage
        File: gluster_backed_registry
  - Name: Working with HTTP Proxies
    File: http_proxies
  - Name: Configuring Global Build Defaults and Overrides
    File: build_defaults_overrides
    Distros: openshift-origin,openshift-enterprise
  - Name: Native Container Routing
    File: native_container_routing
    Distros: openshift-origin,openshift-enterprise
  - Name: Routing from Edge Load Balancers
    File: routing_from_edge_lb
    Distros: openshift-origin,openshift-enterprise
  - Name: Aggregating Container Logs
    File: aggregate_logging
    Distros: openshift-origin,openshift-enterprise
  - Name: Enabling Cluster Metrics
    File: cluster_metrics
    Distros: openshift-origin,openshift-enterprise
  - Name: Customizing the Web Console
    File: web_console_customization
    Distros: openshift-origin,openshift-enterprise
    Distros: openshift-origin,openshift-enterprise
  - Name: Revision History
    File: revhistory_install_config
    Distros: openshift-enterprise

---
Name: Cluster Administration
Dir: admin_guide
Distros: openshift-origin,openshift-enterprise,openshift-dedicated,atomic-*
Topics:
  - Name: Overview
    File: index
  - Name: Managing Nodes
    File: manage_nodes
    Distros: openshift-origin,openshift-enterprise
  - Name: Managing Users
    File: manage_users
    Distros: openshift-origin,openshift-enterprise,atomic-*
  - Name: Managing Projects
    File: managing_projects
  - Name: Configuring Service Accounts
    File: service_accounts
  - Name: Managing Authorization Policies
    File: manage_authorization_policy
  - Name: Managing Security Context Constraints
    File: manage_scc
    Distros: openshift-*
  - Name: Setting Quotas
    File: quota
  - Name: Setting Limit Ranges
    File: limits
  - Name: Pruning Objects
    File: pruning_resources
    Distros: openshift-*
  - Name: Garbage Collection
    File: garbage_collection
    Distros: openshift-*
  - Name: Scheduler
    File: scheduler
    Distros: openshift-origin,openshift-enterprise,openshift-dedicated
  - Name: Configuring Global Build Defaults and Overrides
    File: osd_build_defaults_overrides
    Distros: openshift-dedicated
  - Name: Allocating Node Resources
    File: allocating_node_resources
    Distros: openshift-origin,openshift-enterprise,atomic-*
  - Name: Overcommitting
    File: overcommit
    Distros: openshift-origin,openshift-enterprise
  - Name: Limit Run-once Pod Duration
    File: limit_runonce_pod_duration
    Distros: openshift-origin,openshift-enterprise
  - Name: Monitoring Routers
    File: router
    Distros: openshift-origin,openshift-enterprise
  - Name: High Availability
    File: high_availability
    Distros: openshift-origin,openshift-enterprise
  - Name: Managing Pod Networks
    File: pod_network
    Distros: openshift-*
  - Name: IPtables
    File: iptables
    Distros: openshift-origin,openshift-enterprise
  - Name: Securing Builds by Strategy
    File: securing_builds
    Distros: openshift-origin,openshift-enterprise
  - Name: Building Dependency Trees
    File: building_dependency_trees
    Distros: openshift-origin,openshift-enterprise
  - Name: Troubleshooting Networking
    File: sdn_troubleshooting
    Distros: openshift-origin,openshift-enterprise
  - Name: Revision History
    File: revhistory_admin_guide
    Distros: openshift-enterprise,openshift-dedicated

---
Name: User Guide
Dir: dev_guide
Distros: atomic-*
Topics:
  - Name: Overview
    File: index
  - Name: Authentication
    File: authentication
  - Name: Managing Images
    File: managing_images

---
Name: CLI Reference
Dir: cli_reference
Distros: openshift-*,atomic-*
Topics:
  - Name: Overview
    File: index
  - Name: Get Started with the CLI
    File: get_started_cli
  - Name: Managing CLI Profiles
    File: manage_cli_profiles
  - Name: Developer CLI Operations
    File: basic_cli_operations
    Distros: openshift-*
  - Name: Administrator CLI Operations
    File: admin_cli_operations
  - Name: Revision History
    File: revhistory_cli_reference
    Distros: openshift-enterprise,openshift-dedicated

---
Name: Developer Guide
Dir: dev_guide
Distros: openshift-*
Topics:
  - Name: Overview
    File: index
  - Name: Application Life Cycle Examples
    File: application_lifecycle
  - Name: Authentication
    File: authentication
  - Name: Projects
    File: projects
  - Name: Creating New Applications
    File: new_app
  - Name: Application Tutorials
    Dir: app_tutorials
    Topics:
      - Name: Overview
        File: index
      - Name: Quickstart Templates
        File: quickstarts
      - Name: Ruby on Rails
        File: ruby_on_rails
  - Name: Templates
    File: templates
  - Name: Service Accounts
    File: service_accounts
  - Name: Builds
    File: builds
  - Name: Managing Images
    File: managing_images
  - Name: Quotas and Limit Ranges
    File: compute_resources
  - Name: Deployments
    File: deployments
  - Name: Routes
    File: routes
  - Name: Integrating External Services
    File: integrating_external_services
  - Name: Secrets
    File: secrets
  - Name: ConfigMaps
    File: configmaps
  - Name: Pod Autoscaling
    File: pod_autoscaling
  - Name: Managing Volumes
    File: volumes
  - Name: Using Persistent Volumes
    File: persistent_volumes
  - Name: Executing Remote Commands
    File: executing_remote_commands
  - Name: Copying Files
    File: copy_files_to_container
  - Name: Port Forwarding
    File: port_forwarding
  - Name: Shared Memory
    File: shared_memory
  - Name: Application Health
    File: application_health
  - Name: Events
    File: events
  - Name: Downward API
    File: downward_api
  - Name: Managing Environment Variables
    File: environment_variables
  - Name: Jobs
    File: jobs
  - Name: Revision History
    File: revhistory_dev_guide
    Distros: openshift-enterprise,openshift-dedicated

---
Name: Creating Images
Dir: creating_images
Distros: openshift-*
Topics:
  - Name: Overview
    File: index
  - Name: Guidelines
    File: guidelines
  - Name: Image Metadata
    File: metadata
  - Name: S2I Requirements
    File: s2i
  - Name: Testing S2I Images
    File: s2i_testing
  - Name: Custom Builder
    File: custom
  - Name: Revision History
    File: revhistory_creating_images
    Distros: openshift-enterprise,openshift-dedicated

---
Name: Using Images
Dir: using_images
Distros: openshift-*
Topics:
  - Name: Overview
    File: index
    Distros: openshift-online
  - Name: Source-to-Image (S2I)
    Dir: s2i_images
    Topics:
      - Name: Overview
        File: index
      - Name: Node.js
        File: nodejs
      - Name: Ruby
        File: ruby
      - Name: Perl
        File: perl
      - Name: PHP
        File: php
      - Name: Python
        File: python
      - Name: Java
        File: java
        Distros: openshift-origin,openshift-online
  - Name: Database Images
    Dir: db_images
    Topics:
      - Name: Overview
        File: index
      - Name: MySQL
        File: mysql
      - Name: PostgreSQL
        File: postgresql
      - Name: MongoDB
        File: mongodb
  - Name: Docker Images
    Dir: docker_images
    Topics:
      - Name: Overview
        File: index
  - Name: Other Images
    Dir: other_images
    Topics:
      - Name: Overview
        File: index
      - Name: Jenkins
        File: jenkins
  - Name: xPaaS Middleware Images
    Dir: xpaas_images
    Distros: openshift-online,openshift-enterprise,openshift-dedicated
    Topics:
      - Name: Overview
        File: index
      - Name: JBoss EAP
        File: eap
      - Name: JBoss A-MQ
        File: a_mq
      - Name: JBoss Web Server
        File: jws
      - Name: JBoss Fuse Integration Services
        File: fuse
      - Name: Decision Server
        File: decision_server
      - Name: JBoss Data Grid
        File: data_grid
      - Name: Single Sign-On (SSO)
        File: sso
  - Name: Revision History
    File: revhistory_using_images
    Distros: openshift-enterprise,openshift-dedicated


---
Name: REST API Reference
Dir: rest_api
Topics:
  - Name: Overview
    File: index
  - Name: OpenShift v1
    File: openshift_v1
  - Name: Kubernetes v1
    File: kubernetes_v1
  - Name: Revision History
    File: revhistory_rest_api
    Distros: openshift-enterprise,openshift-dedicated