Skip to content

Commit

Permalink
Adding snippets folder and all required symbolic links
Browse files Browse the repository at this point in the history
  • Loading branch information
mjpytlak authored and kalexand-rh committed Feb 2, 2022
1 parent d1672c0 commit 2e9b9d8
Show file tree
Hide file tree
Showing 116 changed files with 117 additions and 46 deletions.
1 change: 1 addition & 0 deletions adding_service_cluster/snippets
1 change: 1 addition & 0 deletions administering_a_cluster/snippets
1 change: 1 addition & 0 deletions applications/snippets
1 change: 1 addition & 0 deletions architecture/snippets
1 change: 1 addition & 0 deletions authentication/snippets
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ You back up applications by creating a xref:../../../backup_and_restore/applicat
The `Backup` CR creates backup files for Kubernetes resources and internal images, on S3 object storage, and snapshots for persistent volumes (PVs), if the cloud provider uses a native snapshot API or the xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc#oadp-backing-up-pvs-csi_backing-up-applications[Container Storage Interface (CSI)] to create snapshots, such as OpenShift Container Storage 4. For more information, see xref:../../../storage/container_storage_interface/persistent-storage-csi-snapshots.adoc#persistent-storage-csi-snapshots[CSI volume snapshots].

:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

If your cloud provider has a native snapshot API or supports xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc#oadp-backing-up-pvs-csi_backing-up-applications[Container Storage Interface (CSI) snapshots], the `Backup` CR backs up persistent volumes by creating snapshots. For more information, see the xref:../../../storage/container_storage_interface/persistent-storage-csi-snapshots.adoc#persistent-storage-csi-snapshots-overview_persistent-storage-csi-snapshots[Overview of CSI volume snapshots] in the {product-title} documentation.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ To back up Kubernetes resources and internal images, you must have object storag
* S3-compatible object storage, such as Noobaa or Minio
:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

You can back up persistent volumes (PVs) by using snapshots or Restic.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ toc::[]
You install the Openshift API for Data Protection (OADP) with Amazon Web Services (AWS) by installing the OADP Operator, configuring AWS for Velero, and then installing the Data Protection Application.

:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

To install the OADP Operator in a restricted network environment, you must first disable the default OperatorHub sources and mirror the Operator catalog. See xref:../../../operators/admin/olm-restricted-networks.adoc#olm-restricted-networks[Using Operator Lifecycle Manager on restricted networks] for details.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ toc::[]
You install the Openshift API for Data Protection (OADP) with Microsoft Azure by installing the OADP Operator, configuring Azure for Velero, and then installing the Data Protection Application.

:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

To install the OADP Operator in a restricted network environment, you must first disable the default OperatorHub sources and mirror the Operator catalog. See xref:../../../operators/admin/olm-restricted-networks.adoc#olm-restricted-networks[Using Operator Lifecycle Manager on restricted networks] for details.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ toc::[]
You install the Openshift API for Data Protection (OADP) with Google Cloud Platform (GCP) by installing the OADP Operator, configuring GCP for Velero, and then installing the Data Protection Application.

:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

To install the OADP Operator in a restricted network environment, you must first disable the default OperatorHub sources and mirror the Operator catalog. See xref:../../../operators/admin/olm-restricted-networks.adoc#olm-restricted-networks[Using Operator Lifecycle Manager on restricted networks] for details.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ You install the Openshift API for Data Protection (OADP) with Multicloud Object
MCG is a component of OpenShift Container Storage (OCS). You configure MCG as a backup location in the `DataProtectionApplication` custom resource (CR).

:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

If your cloud provider has a native snapshot API, configure a snapshot location. If your cloud provider does not support snapshots or if your storage is NFS, you can create backups with Restic.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ You install the Openshift API for Data Protection (OADP) with OpenShift Containe
You can configure xref:../../../backup_and_restore/application_backup_and_restore/installing/installing-oadp-mcg.adoc#installing-oadp-mcg[Multicloud Object Gateway] or any S3-compatible object storage as a backup location in the `DataProtectionApplication` custom resource (CR).

:FeatureName: The `CloudStorage` API for S3 storage
include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

If the cloud provider has a native snapshot API, you can configure cloud storage as a snapshot location in the `DataProtectionApplication` CR. You do not need to specify a snapshot location for Restic or Container Storage Interface (CSI) snapshots.

Expand Down
1 change: 1 addition & 0 deletions backup_and_restore/application_backup_and_restore/snippets
2 changes: 1 addition & 1 deletion backup_and_restore/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ As a cluster administrator, you can back up and restore applications running on
// ** S3-compatible object storage, such as Noobaa or Minio
//
// :FeatureName: The `CloudStorage` API for S3 storage
// include::modules/technology-preview.adoc[]
// include::snippets/technology-preview.adoc[]
//
// * To back up PVs with snapshots, you must have cloud storage that has a native snapshot API or supports Container Storage Interface (CSI) snapshots, such as the following providers:
//
Expand Down
1 change: 1 addition & 0 deletions backup_and_restore/snippets
1 change: 1 addition & 0 deletions cicd/snippets
1 change: 1 addition & 0 deletions cli_reference/snippets
1 change: 1 addition & 0 deletions cloud_infrastructure_access/snippets
2 changes: 1 addition & 1 deletion contributing_to_docs/doc_guidelines.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -658,7 +658,7 @@ You must get approval from the Engineering, QE, and Docs teams before embedding
== Indicating Technology Preview features

To indicate that a feature is in Technology Preview, include the
`modules/technology-preview.adoc` file in the feature's assembly to keep the
`snippets/technology-preview.adoc` file in the feature's assembly to keep the
supportability wording consistent across Technology Preview features and provide a value for the :FeatureName: variable before you include this module.

See link:https://github.com/openshift/openshift-docs/pull/13878/files#diff-615ba1bf3b09d11a9c2604b775aa32f2[an example] of how this is applied.
Expand Down
1 change: 1 addition & 0 deletions contributing_to_docs/snippets
1 change: 1 addition & 0 deletions getting_started/snippets
2 changes: 1 addition & 1 deletion hardware_enablement/psap-driver-toolkit.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ toc::[]
Learn about the Driver Toolkit and how you can use it as a base image for driver containers for enabling special software and hardware devices on Kubernetes.

:FeatureName: The Driver Toolkit
include::modules/technology-preview.adoc[leveloffset=+0]
include::snippets/technology-preview.adoc[leveloffset=+0]

include::modules/psap-driver-toolkit.adoc[leveloffset=+1]

Expand Down
2 changes: 1 addition & 1 deletion hardware_enablement/psap-special-resource-operator.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Learn about the Special Resource Operator (SRO) and how you can use it to build


:FeatureName: The Special Resource Operator
include::modules/technology-preview.adoc[leveloffset=+0]
include::snippets/technology-preview.adoc[leveloffset=+0]

include::modules/psap-special-resource-operator.adoc[leveloffset=+1]

Expand Down
1 change: 1 addition & 0 deletions hardware_enablement/snippets
1 change: 1 addition & 0 deletions identity_providers/snippets
1 change: 1 addition & 0 deletions installing/snippets
1 change: 1 addition & 0 deletions jaeger/snippets
1 change: 1 addition & 0 deletions logging/snippets
1 change: 1 addition & 0 deletions machine_management/snippets
1 change: 1 addition & 0 deletions metering/snippets
1 change: 1 addition & 0 deletions metrics/snippets
1 change: 1 addition & 0 deletions migrating_from_ocp_3_to_4/snippets
1 change: 1 addition & 0 deletions migration_toolkit_for_containers/snippets
1 change: 1 addition & 0 deletions mod_docs_guide/snippets
2 changes: 1 addition & 1 deletion monitoring/application-monitoring.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ toc::[]
You can configure custom metrics scraping for your applications. For that, you deploy the Prometheus Operator and a custom Prometheus instance and Alertmanager instance in the namespace where your application is.

:FeatureName: Application monitoring
include::modules/technology-preview.adoc[leveloffset=+0]
include::snippets/technology-preview.adoc[leveloffset=+0]

include::modules/monitoring-configuring-cluster-for-application-monitoring.adoc[leveloffset=+1]
include::modules/monitoring-configuring-monitoring-for-an-application.adoc[leveloffset=+1]
Expand Down
2 changes: 1 addition & 1 deletion monitoring/configuring-hpa-for-an-application.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ toc::[]
You can configure Horizontal Pod Autoscaling (HPA) for an application that exports metrics.

:FeatureName: Horizontal Pod Autoscaling for an application
include::modules/technology-preview.adoc[leveloffset=+0]
include::snippets/technology-preview.adoc[leveloffset=+0]

== Prerequisites

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ include::modules/common-attributes.adoc[]

toc::[]

:FeatureName: Alert routing for user-defined projects
include::modules/technology-preview.adoc[leveloffset=+1]
:FeatureName: Alert routing for user-defined projects
include::snippets/technology-preview.adoc[leveloffset=+1]

[role="_abstract"]
In {product-title} {product-version}, a cluster administrator can enable alert routing for user-defined projects.
Expand All @@ -21,7 +21,7 @@ include::modules/monitoring-enabling-alert-routing-for-user-defined-projects.ado
// Granting users permission to configure alert routing for user-defined projects
include::modules/monitoring-granting-users-permission-to-configure-alert-routing-for-user-defined-projects.adoc[leveloffset=+1]

// Disabling alert routing for user-defined projects
// Disabling alert routing for user-defined projects
include::modules/monitoring-disabling-alert-routing-for-user-defined-projects.adoc[leveloffset=+1]

.Additional resources
Expand All @@ -32,5 +32,3 @@ include::modules/monitoring-disabling-alert-routing-for-user-defined-projects.ad
== Next steps

* xref:../monitoring/managing-alerts.adoc#creating-alert-routing-for-user-defined-projects_managing-alerts[Creating alert routing for user defined projects]


1 change: 1 addition & 0 deletions monitoring/snippets
1 change: 1 addition & 0 deletions networking/hardware_networks/snippets
2 changes: 1 addition & 1 deletion networking/hardware_networks/using-dpdk-and-rdma.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ include::modules/nw-sriov-dpdk-example-mellanox.adoc[leveloffset=+1]
== Using a virtual function in RDMA mode with a Mellanox NIC

:FeatureName: RDMA over Converged Ethernet (RoCE)
include::modules/technology-preview.adoc[leveloffset=+0]
include::snippets/technology-preview.adoc[leveloffset=+0]

// Use a tag to skip header and include content only
include::modules/nw-sriov-rdma-example-mellanox.adoc[tag=content]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ toc::[]

The Kubernetes NMState Operator provides a Kubernetes API for performing state-driven network configuration across the {product-title} cluster's nodes with NMState. The Kubernetes NMState Operator provides users with functionality to configure various network interface types, DNS, and routing on cluster nodes. Additionally, the daemons on the cluster nodes periodically report on the state of each node's network interfaces to the API server.

include::modules/technology-preview.adoc[]
include::snippets/technology-preview.adoc[]

Before you can use NMState with {product-title}, you must install the Kubernetes NMState Operator.

Expand Down
1 change: 1 addition & 0 deletions networking/k8s_nmstate/snippets
1 change: 1 addition & 0 deletions networking/snippets
2 changes: 1 addition & 1 deletion networking/using-ptp.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ include::modules/common-attributes.adoc[]
toc::[]

:FeatureName: Precision Time Protocol (PTP) hardware
include::modules/technology-preview.adoc[leveloffset=+1]
include::snippets/technology-preview.adoc[leveloffset=+1]

[id="about-using-ptp-hardware"]
== About PTP hardware
Expand Down
2 changes: 1 addition & 1 deletion nodes/nodes/eco-node-health-check-operator.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ xref:../../nodes/nodes/eco-poison-pill-operator.adoc#poison-pill-operator-remedi

:FeatureName: Node Health Check Operator

include::modules/technology-preview.adoc[leveloffset=+1]
include::snippets/technology-preview.adoc[leveloffset=+1]

include::modules/eco-node-health-check-operator-about.adoc[leveloffset=+1]

Expand Down
1 change: 1 addition & 0 deletions nodes/nodes/snippets
1 change: 1 addition & 0 deletions nodes/snippets
1 change: 1 addition & 0 deletions openshift_images/snippets
1 change: 1 addition & 0 deletions operators/snippets
1 change: 1 addition & 0 deletions osd_architecture/snippets
1 change: 1 addition & 0 deletions osd_cluster_create/snippets
1 change: 1 addition & 0 deletions osd_notifications/snippets
1 change: 1 addition & 0 deletions osd_planning/snippets
1 change: 1 addition & 0 deletions osd_policy/snippets
1 change: 1 addition & 0 deletions osd_private_connections/snippets
1 change: 1 addition & 0 deletions osd_quickstart/snippets
1 change: 1 addition & 0 deletions planning/snippets
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ A disconnected cluster, also known as a restricted cluster, does not have an act
This topic describes the general process for converting an existing, connected cluster into a disconnected cluster.

:FeatureName: The process for converting a cluster from connected to disconnected
include::modules/technology-preview.adoc[leveloffset=+1]
include::snippets/technology-preview.adoc[leveloffset=+1]

include::modules/installation-about-mirror-registry.adoc[leveloffset=+1]

Expand Down
1 change: 1 addition & 0 deletions post_installation_configuration/snippets
1 change: 1 addition & 0 deletions registry/snippets
1 change: 1 addition & 0 deletions release_notes/snippets
1 change: 1 addition & 0 deletions rosa_architecture/snippets
1 change: 1 addition & 0 deletions rosa_cli/snippets
1 change: 1 addition & 0 deletions rosa_getting_started/snippets
1 change: 1 addition & 0 deletions rosa_getting_started_sts/snippets
1 change: 1 addition & 0 deletions rosa_planning/snippets
1 change: 1 addition & 0 deletions rosa_policy/snippets
1 change: 1 addition & 0 deletions rosa_support/snippets
1 change: 1 addition & 0 deletions router/snippets
1 change: 1 addition & 0 deletions sandboxed_containers/snippets
1 change: 1 addition & 0 deletions scalability_and_performance/snippets
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ toc::[]
Use zero touch provisioning (ZTP) to provision distributed units at new edge sites in a disconnected environment. The workflow starts when the site is connected to the network and ends with the CNF workload deployed and running on the site nodes.

:FeatureName: ZTP for RAN deployments
include::modules/technology-preview.adoc[leveloffset=+1]
include::snippets/technology-preview.adoc[leveloffset=+1]

include::modules/ztp-provisioning-edge-sites-at-scale.adoc[leveloffset=+1]

Expand Down
1 change: 1 addition & 0 deletions security/snippets
2 changes: 1 addition & 1 deletion serverless/develop/serverless-applications.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ include::modules/serverless-https-redirect-service.adoc[leveloffset=+1]
== Using kn CLI in offline mode

:FeatureName: The offline mode of the kn CLI
include::modules/technology-preview.adoc[leveloffset=+1]
include::snippets/technology-preview.adoc[leveloffset=+1]

include::modules/kn-service-offline-about.adoc[leveloffset=+2]
include::modules/kn-service-offline-create.adoc[leveloffset=+2]
2 changes: 1 addition & 1 deletion serverless/discover/serverless-functions-about.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ include::modules/serverless-document-attributes.adoc[]
toc::[]

:FeatureName: {FunctionsProductName}
include::modules/technology-preview.adoc[leveloffset=+2]
include::snippets/technology-preview.adoc[leveloffset=+2]

{FunctionsProductName} enables developers to create and deploy stateless, event-driven functions as a Knative service on {product-title}.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ include::modules/common-attributes.adoc[]
toc::[]

:FeatureName: {FunctionsProductName}
include::modules/technology-preview.adoc[leveloffset=+2]
include::snippets/technology-preview.adoc[leveloffset=+2]

After you have xref:../../serverless/functions/serverless-functions-getting-started.adoc#serverless-create-func-kn_serverless-functions-getting-started[created a Golang function project], you can modify the template files provided to add business logic to your function.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ include::modules/common-attributes.adoc[]
toc::[]

:FeatureName: {FunctionsProductName}
include::modules/technology-preview.adoc[leveloffset=+2]
include::snippets/technology-preview.adoc[leveloffset=+2]

After you have xref:../../serverless/functions/serverless-functions-getting-started.adoc#serverless-create-func-kn_serverless-functions-getting-started[created a Node.js function project], you can modify the template files provided to add business logic to your function.

Expand Down
Loading

0 comments on commit 2e9b9d8

Please sign in to comment.