Skip to content

Commit ab0b997

Browse files
author
Brice Fallon-Freeman
authored
Merge pull request openshift#7593 from bfallonf/day_two_guide_2
Added day2 guide
2 parents 04ee439 + 4305611 commit ab0b997

35 files changed

+6274
-11
lines changed

_topic_map.yml

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -521,6 +521,23 @@ Topics:
521521
- Name: Certificate Management
522522
File: certificate_management
523523
---
524+
Name: Day Two Operations Guide
525+
Dir: day_two_guide
526+
Distros: openshift-origin,openshift-enterprise
527+
Topics:
528+
- Name: Overview
529+
File: index
530+
- Name: Run-once tasks
531+
File: run_once_tasks
532+
- Name: Environment health checks
533+
File: environment_health_checks
534+
- Name: Host-level tasks
535+
File: host_level_tasks
536+
- Name: Project-level tasks
537+
File: project_level_tasks
538+
- Name: Docker tasks
539+
File: docker_tasks
540+
---
524541
Name: Cluster Administration
525542
Dir: admin_guide
526543
Distros: openshift-origin,openshift-enterprise,openshift-dedicated,atomic-*

day_two_guide/docker_tasks.adoc

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
[[day_two_docker_tasks]]
2+
= Docker tasks
3+
{product-author}
4+
{product-version}
5+
:data-uri:
6+
:icons:
7+
:experimental:
8+
:toc: macro
9+
:toc-title:
10+
:prewrap!:
11+
12+
toc::[]
13+
14+
{product-title} uses Docker to run applications in pods that are composed by any number of containers.
15+
16+
As a cluster administrator, sometimes Docker requires some extra configuration in order to efficiently run elements of the {product-title} installation.
17+
18+
[[day-two-guide-increasing-docker-storage]]
19+
== Increasing Docker storage
20+
21+
include::day_two_guide/topics/increasing_docker_storage.adoc[]
22+
23+
[[day-two-guide-managing-docker-certs]]
24+
== Managing Docker certificates
25+
26+
include::day_two_guide/topics/managing_docker_certs.adoc[]
27+
28+
[[day-two-guide-managing-docker-registries]]
29+
== Managing Docker registries
30+
31+
include::day_two_guide/topics/managing_docker_registries.adoc[]
32+
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
[[day_two_environment_health_checks]]
2+
= Environment health checks
3+
{product-author}
4+
{product-version}
5+
:data-uri:
6+
:icons:
7+
:experimental:
8+
:toc: macro
9+
:toc-title:
10+
:prewrap!:
11+
12+
toc::[]
13+
14+
This topic contains steps to verify the overall health of the {product-title}
15+
cluster and the various components, as well as describing the intended behavior.
16+
17+
Knowing the verification process for the various components is the first step to
18+
troubleshooting issues. If experiencing issues, you can use the checks provided
19+
in this section to diagnose any problems.
20+
21+
[[day-two-guide-complete-deployment-health-check]]
22+
== Checking complete environment health
23+
24+
include::day_two_guide/topics/complete_deployment_health_check.adoc[]
25+
26+
[[day-two-guide-host-health]]
27+
== Host health
28+
29+
include::day_two_guide/topics/host_health.adoc[]
30+
31+
[[day-two-guide-network-connectivity]]
32+
== Network connectivity
33+
34+
include::day_two_guide/topics/network_connectivity.adoc[]
35+
36+
[[day-two-guide-storage]]
37+
== Storage
38+
39+
include::day_two_guide/topics/storage.adoc[]
40+
41+
[[day-two-guide-docker-storage]]
42+
== Docker storage
43+
44+
include::day_two_guide/topics/docker_storage.adoc[]
45+
46+
[[day-two-guide-api-service-status]]
47+
== API service status
48+
49+
include::day_two_guide/topics/api_service_status.adoc[]
50+
51+
////
52+
[[day-two-guide-controller-role-verification]]
53+
== Controller role verification
54+
55+
include::day_two_guide/topics/controller_role_verification.adoc[]
56+
////
57+
58+
[[day-two-guide-verifying_mtu]]
59+
== Verifying correct Maximum Transmission Unit (MTU) size
60+
61+
include::day_two_guide/topics/verifying_mtu.adoc[]
62+

day_two_guide/host_level_tasks.adoc

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
[[day_two_host_level_tasks]]
2+
= Host-level tasks
3+
{product-author}
4+
{product-version}
5+
:data-uri:
6+
:icons:
7+
:experimental:
8+
:toc: macro
9+
:toc-title:
10+
:prewrap!:
11+
12+
toc::[]
13+
14+
== Adding a host to the cluster
15+
16+
For information on adding master or node hosts to a cluster, see the
17+
xref:../install_config/adding_hosts_to_existing_cluster.adoc#install-config-adding-hosts-to-cluster[Adding
18+
hosts to an existing cluster] section in the Install and configuration guide.
19+
20+
== Master host tasks
21+
22+
[[day-two-guide-deprecating-master]]
23+
=== Deprecating a master host
24+
25+
include::day_two_guide/topics/deprecating_master.adoc[]
26+
27+
[[day-two-guide-master-backup]]
28+
=== Creating a master host backup
29+
30+
include::day_two_guide/topics/master_backup.adoc[]
31+
32+
[[day-two-guide-restore-master]]
33+
=== Restoring a master host backup
34+
35+
include::day_two_guide/topics/restore_master.adoc[]
36+
37+
== Node host tasks
38+
39+
[[day-two-guide-deprecating-node]]
40+
=== Deprecating a node host
41+
42+
include::day_two_guide/topics/deprecating_node.adoc[]
43+
44+
[[day-two-guide-node-backup]]
45+
=== Creating a node host backup
46+
47+
include::day_two_guide/topics/node_backup.adoc[]
48+
49+
[[day-two-guide-restore-node]]
50+
=== Restoring a node host backup
51+
52+
include::day_two_guide/topics/restore_node.adoc[]
53+
54+
[[day-two-guide-node-maintenance]]
55+
=== Node maintenance
56+
57+
See xref:../admin_guide/manage_nodes#admin-guide-manage-nodes[Managing nodes] or
58+
xref:../admin_guide/manage_pods#admin-guide-manage-pods[Managing pods] topics
59+
for various node management options. These include:
60+
61+
* xref:../admin_guide/manage_nodes#marking-nodes-as-unschedulable-or-schedulable[Marking Nodes as Unschedulable or Schedulable]
62+
* xref:../admin_guide/manage_nodes#evacuating-pods-on-nodes[Evacuating Pods on Nodes]
63+
* xref:../admin_guide/manage_pods#managing-pods-poddisruptionbudget[Setting Pod Disruption Budgets]
64+
65+
////
66+
include::day_two_guide/topics/node_maintenance.adoc[]
67+
////
68+
69+
[[day-two-guide-etcd-backup]]
70+
== etcd tasks
71+
72+
include::day_two_guide/topics/etcd_backup.adoc[]
73+
74+
75+

day_two_guide/index.adoc

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
[[day-two-guide-index]]
2+
= Overview
3+
{product-author}
4+
{product-version}
5+
:data-uri:
6+
:icons:
7+
:experimental:
8+
9+
This section is built for {product-title} administrators with a fresh
10+
installation.
11+
12+
While the xref:../admin_guide/index.adoc#admin-guide-index[{product-title}
13+
Cluster administration guide] is focused more on configuration, this guide will
14+
describe an overview of common daily maintenance tasks.
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
[[day_two_project_level_tasks]]
2+
= Project-level tasks
3+
{product-author}
4+
{product-version}
5+
:data-uri:
6+
:icons:
7+
:experimental:
8+
:toc: macro
9+
:toc-title:
10+
:prewrap!:
11+
12+
toc::[]
13+
14+
[[day-two-guide-project-backup]]
15+
== Project backup
16+
17+
include::day_two_guide/topics/project_backup.adoc[]
18+
19+
[[day-two-guide-pvc-backup-restore]]
20+
== PVC backup
21+
22+
include::day_two_guide/topics/pvc_backup_and_restore.adoc[]
23+
24+
[[day-two-guide-pruning-images]]
25+
== Pruning images and Containers
26+
27+
See the
28+
xref:../admin_guide/pruning-resources.adoc#admin-guide-pruning-resources[Pruning
29+
Resources] topic for information about pruning collected data and older versions
30+
of objects.
31+
32+
////
33+
include::day_two_guide/topics/pruning_images_and_containers.adoc[]
34+
////

day_two_guide/run_once_tasks.adoc

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
[[day-two-run-once]]
2+
= Run-once tasks
3+
{product-author}
4+
{product-version}
5+
:data-uri:
6+
:icons:
7+
:experimental:
8+
:toc: macro
9+
:toc-title:
10+
:prewrap!:
11+
12+
toc::[]
13+
14+
15+
After installing {product-title}, your system might need extra configuration to
16+
ensure your hosts consistently run smoothly.
17+
18+
While these are classified as run-once tasks, you can perform any of these at
19+
any time if any circumstances change.
20+
21+
[[day-two-guide-ntp-synchronization]]
22+
== NTP synchronization
23+
24+
include::day_two_guide/topics/ntp_synchronization.adoc[]
25+
26+
[[day-two-guide-entropy]]
27+
== Entropy
28+
29+
include::day_two_guide/topics/entropy.adoc[]
30+
31+
[[day-two-guide-default-storage-class]]
32+
== Checking the default storage class
33+
34+
include::day_two_guide/topics/default_storage_class.adoc[]

0 commit comments

Comments
 (0)