openstack/openstack-ansible
Code Issues Proposed changes

Update documentation in the swift config file

Browse Source 
Change-Id: I4cabbb0c620933a4e26e0172820ad0c728f544ff
This commit is contained in:
Matthew Kassawara 2015-05-11 08:45:25 -05:00
parent 58212d9b8a
commit c64418d2f4
1 changed files with 304 additions and 251 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

423
etc/openstack_deploy/conf.d/swift.yml.example
View File

@ -16,65 +16,98 @@
# Overview # Overview
# ======== # ========
# #
# This file contains the configuration for the Object Storage (swift) # This file contains the configuration for the OpenStack Ansible Deployment
# service. Only enable these options for environments that contain the # (OSAD) Object Storage (swift) service. Only enable these options for
# Object Storage service. For more information on Object Storage options, # deployments that contain the Object Storage service. For more information on
# see the documentation at # these options, see the documentation at
# #
# http://docs.openstack.org/developer/swift/index.html # http://docs.openstack.org/developer/swift/index.html
# #
# The hierarchical structure of this file supports overrides for most # You can customize the options in this file and copy it to
# options. However, for typical deployments, defining options closest # /etc/openstack_deploy/conf.d/swift.yml or create a new
# to the top level provides a functional configuration. # file containing only necessary options for your environment
# before deployment.
#
# OSAD implements PyYAML to parse YAML files and therefore supports structure
# and formatting options that augment traditional YAML. For example, aliases
# or references. For more information on PyYAML, see the documentation at
#
# http://pyyaml.org/wiki/PyYAMLDocumentation
# #
# Configuration reference # Configuration reference
# ======================= # =======================
# #
# Level: swift (required) # Level: global_overrides (required)
# Contains global options. # Contains global options that require customization for a deployment. For
# example, the ring stricture. This level also provides a mechanism to
# override other options defined in the playbook structure.
# #
# Option: storage_network (optional, string) # Level: swift (required)
# Network to use for object storage operations. Defaults to the management # Contains options for swift.
# network if omitted. #
# If using a storage network, specify the network bridge containing it, # Option: storage_network (required, string)
# typically 'br-storage'. # Name of the storage network bridge on target hosts. Typically
# 'br-storage'.
# #
# Option: repl_network (optional, string) # Option: repl_network (optional, string)
# Network to use for object replication operations. Defaults to the # Name of the replication network bridge on target hosts. Typically
# 'storage_network' value if omitted. # 'br-repl'. Defaults to the value of the 'storage_network' option.
# If using a replication network, specify the network bridge containing it,
# typically 'br-repl'.
# #
# Option: part_power (required, integer) # Option: part_power (required, integer)
# Partition power. Immutable without rebuilding the rings. # Partition power. Applies to all rings unless overridden at the 'account'
# Applies to all rings unless overridden at the 'account' or 'container' # or 'container' levels or within a policy in the 'storage_policies' level.
# levels or within a policy under the 'storage_policies' level. # Immutable without rebuilding the rings.
# #
# Option: repl_number (optional, integer) # Option: repl_number (optional, integer)
# Number of replicas for each partition. Defaults to 3. # Number of replicas for each partition. Applies to all rings unless
# Applies to all rings unless overridden at the 'account' or 'container' # overridden at the 'account' or 'container' levels or within a policy
# levels or within a policy under the 'storage_policies' level. # in the 'storage_policies' level. Defaults to 3.
# #
# Option: min_part_hours (optional, integer) # Option: min_part_hours (optional, integer)
# Minimum time in hours between multiple moves of the same partition. # Minimum time in hours between multiple moves of the same partition.
# Defaults to 1.
# Applies to all rings unless overridden at the 'account' or 'container' # Applies to all rings unless overridden at the 'account' or 'container'
# levels or within a policy under the 'storage_policies' level. # levels or within a policy in the 'storage_policies' level. Defaults
# to 1.
# #
# Option: region (optional, integer) # Option: region (optional, integer)
# Region of a disk. Defaults to 1. # Region of a disk. Applies to all disks in all storage hosts unless
# Applies to all disks in all hosts unless overridden deeper in the # overridden deeper in the structure. Defaults to 1.
# structure.
# #
# Option: zone (optional, integer) # Option: zone (optional, integer)
# Zone of a disk. Defaults to 0. # Zone of a disk. Applies to all disks in all storage hosts unless
# Applies to all disks in all hosts unless overridden deeper in the # overridden deeper in the structure. Defaults to 0.
# structure.
# #
# Option: weight (optional, integer) # Option: weight (optional, integer)
# Weight of a disk. Defaults to 100. # Weight of a disk. Applies to all disks in all storage hosts unless
# Applies to all disks in all hosts unless overridden deeper in the # overridden deeper in the structure. Defaults to 100.
# structure. #
# Example:
#
# Define a typical deployment:
#
# - Storage network that uses the 'br-storage' bridge. Proxy containers
# typically use the 'storage' IP address pool. However, storage hosts
# use bare metal and require manual configuration of the 'br-storage'
# bridge on each host.
# - Replication network that uses the 'br-repl' bridge. Only storage hosts
# contain this network. Storage hosts use bare metal and require manual
# configuration of the bridge on each host.
# - Ring configuration with partition power of 8, three replicas of each
# file, and minimum 1 hour between migrations of the same partition. All
# rings use region 1 and zone 0. All disks include a weight of 100.
#
# swift:
# storage_network: 'br-storage'
# replication_network: 'br-repl'
# part_power: 8
# repl_number: 3
# min_part_hours: 1
# region: 1
# zone: 0
# weight: 100
#
# Note: Most typical deployments override the 'zone' option in the
# 'swift_vars' level to use a unique zone for each storage host.
# #
# Option: mount_point (required, string) # Option: mount_point (required, string)
# Top-level directory for mount points of disks. Defaults to /mnt. # Top-level directory for mount points of disks. Defaults to /mnt.
@ -88,12 +121,17 @@
# Mount point of a disk. Use one entry for each disk. # Mount point of a disk. Use one entry for each disk.
# Applies to all hosts unless overridden deeper in the structure. # Applies to all hosts unless overridden deeper in the structure.
# #
# The following example shows disks mounted at /mnt/sda and /mnt/sdb # Example:
# on all storage hosts: #
# Mount disks 'sdc', 'sdd', 'sde', and 'sdf' to the '/mnt' directory on all
# storage hosts:
#
# mount_point: /mnt # mount_point: /mnt
# drives: # drives:
# - name: sda # - name: sdc
# - name: sdb # - name: sdd
# - name: sde
# - name: sdf
# #
# Level: account (optional) # Level: account (optional)
# Contains 'min_part_hours' and 'repl_number' options specific to the # Contains 'min_part_hours' and 'repl_number' options specific to the
@ -108,7 +146,7 @@
# the 'index: 0' and 'default: True' options. # the 'index: 0' and 'default: True' options.
# #
# Level: policy (required) # Level: policy (required)
# Contains a storage policy. # Contains a storage policy. Define for each policy.
# #
# Option: name (required, string) # Option: name (required, string)
# Policy name. # Policy name.
@ -118,28 +156,27 @@
# value. # value.
# #
# Option: policy_type (optional, string) # Option: policy_type (optional, string)
# Policy type. Defines if this type of policy, possible values: # Defines policy as replication or erasure coding. Accepts 'replication'
# - replication (default); or # 'erasure_coding' values. Defaults to 'replication' value if omitted.
# - erasure_coding
# #
# Option: ec_type (optional, string) # Option: ec_type (conditionally required, string)
# Defines the erasure code algorithm to use. This option is required # Defines the erasure coding algorithm. Required for erasure coding
# when policy_type == erasure_coding. # policies.
# #
# Option: ec_num_data_fragments (optional, integer) # Option: ec_num_data_fragments (conditionally required, integer)
# Defines the number of data fragments to break object into. This # Defines the number of object data fragments. Required for erasure
# option is required when policy_type == erasure_coding. # coding policies.
# #
# Option: ec_num_parity_fragments (optional, integer) # Option: ec_num_parity_fragments (conditionally required, integer)
# Defines the number of parity fragments to break object into. This # Defines the number of object parity fragments. Required for erasure
# option is required when policy_type == erasure_coding. # coding policies.
# #
# Option: ec_object_segment_size (optional, integer) # Option: ec_object_segment_size (conditionally required, integer)
# Defines the segment size (btyes). Swift will send the incoming object # Defines the size of object segments in bytes. Swift sends incoming
# data a segment size at a time in to the erasure code encoder. # objects to an erasure coding policy in segments of this size.
# This option is required when policy_type == erasure_coding. # Required for erasure coding policies.
# #
# Option: default (optional, boolean) # Option: default (conditionally required, boolean)
# Defines the default policy. One policy must include this option # Defines the default policy. One policy must include this option
# with a 'True' value. # with a 'True' value.
# #
@ -153,105 +190,14 @@
# Number of replicas of each partition in this policy. # Number of replicas of each partition in this policy.
# #
# Option: min_part_hours (optional, integer) # Option: min_part_hours (optional, integer)
# Minimum time between multiple moves of the same partition in this # Minimum time in hours between multiple moves of the same partition
# policy. # in this policy.
# #
# Level: swift_proxy-hosts (required) # Example:
# Contains definitions for proxy hosts.
# #
# Level: <value> (optional, string) # Define three storage policies: A default 'gold' policy, a deprecated
# Name of a proxy host. Typical deployments require at least three # 'silver' policy, and an erasure coding 'ec10-4' policy.
# proxy hosts.
# #
# Option: ip (required, string)
# IP address of the host.
#
# Level: swift_hosts (required)
# Contains definitions for storage hosts.
#
# Level: <value> (required, string)
# Name of a storage host. Typical deployments require at least three
# storage hosts.
#
# Option: ip (required, string)
# IP address of the host.
#
# Note: The following levels and options override any values higher
# in the structure and generally apply to advanced deployments.
#
# Level: container_vars (optional)
# Contains options specific to this host.
#
# Level: swift_vars (optional)
# Contains swift options specific to this host.
#
# Option: region (optional, integer)
# Region of all disks in this host.
#
# Option: zone (optional, integer)
# Zone of all disks in this host.
#
# Option: weight (optional, integer)
# Weight of all disks in this host.
#
# Level: groups (optional)
# Contains groups specific to this host.
# The following example shows a storage host with the account ring,
# container ring, and 'silver' storage policy:
# groups:
# - account
# - container
# - silver
#
# Level: drives (optional)
# Contains the mount points of disks specific to this host.
#
# Level or option: name (optional, string)
# Mount point of a disk specific to this host. Use one entry for
# each disk. Functions as a level for disks that contain additional
# options.
#
# Option: region (optional, integer)
# Region of a disk in this host.
#
# Option: zone (optional, integer)
# Zone of a disk in this host.
#
# Option: weight (optional, integer)
# Weight of a disk in this host.
#
# Level: groups (optional)
# Contains groups for a disk in this host.
# The following example shows a disk with the account ring,
# container ring, and 'silver' storage policy:
# groups:
# - account
# - container
# - silver
# Default (example) configuration
# ===============================
# Global options
# global_overrides:
# swift:
# storage_network: 'br-storage'
# replication_network: 'br-repl'
# part_power: 8
# repl_number: 3
# min_part_hours: 1
# region: 1
# zone: 0
# weight: 100
# mount_point: /mnt
# drives:
# - name: sdc
# - name: sdd
# - name: sde
# - name: sdf
# account:
# container:
# storage_policies: # storage_policies:
# - policy: # - policy:
# name: gold # name: gold
@ -270,55 +216,162 @@
# ec_num_data_fragments: 10 # ec_num_data_fragments: 10
# ec_num_parity_fragments: 4 # ec_num_parity_fragments: 4
# ec_object_segment_size: 1048576 # ec_object_segment_size: 1048576
# Proxy hosts
# swift-proxy_hosts:
# infra-node1:
# ip: 192.0.2.1
# infra-node2:
# ip: 192.0.2.2
# infra-node3:
# ip: 192.0.2.3
# Storage hosts
# #
# The first three hosts contain options for typical deployments. Hosts # --------
# four and five show options for more advanced deployments. #
# Level: swift_proxy-hosts (required)
# List of target hosts on which to deploy the swift proxy service. Recommend
# three minimum target hosts for these services. Typically contains the same
# target hosts as the 'shared-infra_hosts' level in complete OpenStack
# deployments.
#
# Level: <value> (optional, string)
# Name of a proxy host.
#
# Option: ip (required, string)
# IP address of this target host, typically the IP address assigned to
# the management bridge.
#
# Example:
#
# Define three swift proxy hosts:
#
# swift_proxy-hosts:
#
# infra1:
# ip: 172.29.236.101
# infra2:
# ip: 172.29.236.102
# infra3:
# ip: 172.29.236.103
#
# --------
#
# Level: swift_hosts (required)
# List of target hosts on which to deploy the swift storage services.
# Recommend three minimum target hosts for these services.
#
# Level: <value> (required, string)
# Name of a storage host.
#
# Option: ip (required, string)
# IP address of this target host, typically the IP address assigned to
# the management bridge.
#
# Note: The following levels and options override any values higher
# in the structure and generally apply to advanced deployments.
#
# Level: container_vars (optional)
# Contains options for this target host.
#
# Level: swift_vars (optional)
# Contains swift options for this target host. Typical deployments
# use this level to define a unique zone for each storage host.
#
# Option: storage_ip (optional, string)
# IP address to use for accessing the account, container, and object
# services if different than the IP address of the storage network
# bridge on the target host. Also requires manual configuration of
# the host.
#
# Option: repl_ip (optional, string)
# IP address to use for replication services if different than the IP
# address of the replication network bridge on the target host. Also
# requires manual configuration of the host.
#
# Option: region (optional, integer)
# Region of all disks.
#
# Option: zone (optional, integer)
# Zone of all disks.
#
# Option: weight (optional, integer)
# Weight of all disks.
#
# Level: groups (optional)
# List of one of more Ansible groups that apply to this host.
#
# Example:
#
# Deploy the account ring, container ring, and 'silver' policy.
#
# groups:
# - account
# - container
# - silver
#
# Level: drives (optional)
# Contains the mount points of disks specific to this host.
#
# Level or option: name (optional, string)
# Mount point of a disk specific to this host. Use one entry for
# each disk. Functions as a level for disks that contain additional
# options.
#
# Option: storage_ip (optional, string)
# IP address to use for accessing the account, container, and object
# services of a disk if different than the IP address of the storage
# network bridge on the target host. Also requires manual
# configuration of the host.
#
# Option: repl_ip (optional, string)
# IP address to use for replication services of a disk if different
# than the IP address of the replication network bridge on the target
# host. Also requires manual configuration of the host.
#
# Option: region (optional, integer)
# Region of a disk.
#
# Option: zone (optional, integer)
# Zone of a disk.
#
# Option: weight (optional, integer)
# Weight of a disk.
#
# Level: groups (optional)
# List of one or more Ansible groups that apply to this disk.
#
# Example:
#
# Define four storage hosts. The first three hosts contain typical options
# and the last host contains advanced options.
#
# swift_hosts: # swift_hosts:
# swift-node1: # swift-node1:
# ip: 192.0.2.4 # ip: 172.29.236.151
# container_vars:
# swift_vars:
# zone: 0
# swift-node2: # swift-node2:
# ip: 192.0.2.5 # ip: 172.29.236.152
# container_vars:
# swift_vars:
# zone: 1
# swift-node3: # swift-node3:
# ip: 192.0.2.6 # ip: 172.29.236.153
# container_vars:
# swift_vars:
# zone: 2
# swift-node4: # swift-node4:
# ip: 192.0.2.7 # ip: 172.29.236.154
# container_vars: # container_vars:
# swift_vars: # swift_vars:
# zone: 3 # storage_ip: 198.51.100.11
# swift-node5: # repl_ip: 203.0.113.11
# ip: 192.0.2.8 # region: 2
# container_vars: # zone: 0
# swift_vars:
# storage_ip: 198.51.100.8
# repl_ip: 203.0.113.8
# region: 3
# zone: 4
# weight: 200 # weight: 200
# groups: # groups:
# - account # - account
# - container # - container
# - silver # - silver
# drives: # drives:
# - name: sdb # - name: sdc
# storage_ip: 198.51.100.9 # storage_ip: 198.51.100.21
# repl_ip: 203.0.113.9 # repl_ip: 203.0.113.21
# weight: 75 # weight: 75
# groups: # groups:
# - gold # - gold
# - name: sdc
# - name: sdd # - name: sdd
# - name: sde # - name: sde
# - name: sdf # - name: sdf