Write readme.txt into old log directories

This should help operators find the new log files. We do have them
documented, but not everybody reads every word in the docs :)

The readme creation has ignore_errors: true so that if the directory
isn't present at all (e.g. on deployed server environments, which
don't have openstack packages installed), we don't fail the deployment
when we're not able to create the readme.

Change-Id: I6b36db7b7ce8b3e4da566eb7828d0c3b8646a14f
Partial-Bug: #1730957

docker/services/aodh-api.yaml

@@ -160,6 +160,13 @@ outputs:
         with_items:
           - /var/log/containers/aodh
           - /var/log/containers/httpd/aodh-api
+      - name: aodh logs readme
+        copy:
+          dest: /var/log/aodh/readme.txt
+          content: |
+            Log files from aodh containers can be found under
+            /var/log/containers/aodh and /var/log/containers/httpd/aodh-api.
+        ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable aodh service (running under httpd)
           tags: step2

docker/services/aodh-evaluator.yaml

@@ -116,6 +116,13 @@ outputs:
           file:
             path: /var/log/containers/aodh
             state: directory
+        - name: aodh logs readme
+          copy:
+            dest: /var/log/aodh/readme.txt
+            content: |
+              Log files from aodh containers can be found under
+              /var/log/containers/aodh and /var/log/containers/httpd/aodh-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable openstack-aodh-evaluator service
           tags: step2

docker/services/aodh-listener.yaml

@@ -116,6 +116,13 @@ outputs:
           file:
             path: /var/log/containers/aodh
             state: directory
+        - name: aodh logs readme
+          copy:
+            dest: /var/log/aodh/readme.txt
+            content: |
+              Log files from aodh containers can be found under
+              /var/log/containers/aodh and /var/log/containers/httpd/aodh-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable openstack-aodh-listener service
           tags: step2

docker/services/aodh-notifier.yaml

@@ -116,6 +116,13 @@ outputs:
           file:
             path: /var/log/containers/aodh
             state: directory
+        - name: aodh logs readme
+          copy:
+            dest: /var/log/aodh/readme.txt
+            content: |
+              Log files from aodh containers can be found under
+              /var/log/containers/aodh and /var/log/containers/httpd/aodh-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable openstack-aodh-notifier service
           tags: step2

docker/services/barbican-api.yaml

@@ -152,6 +152,13 @@ outputs:
           file:
             path: /var/log/containers/barbican
             state: directory
+        - name: barbican logs readme
+          copy:
+            dest: /var/log/barbican/readme.txt
+            content: |
+              Log files from barbican containers can be found under
+              /var/log/containers/barbican.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable barbican_api service
           tags: step2

docker/services/ceilometer-agent-central.yaml

@@ -129,6 +129,13 @@ outputs:
           file:
             path: /var/log/containers/ceilometer
             state: directory
+        - name: ceilometer logs readme
+          copy:
+            dest: /var/log/ceilometer/readme.txt
+            content: |
+              Log files from ceilometer containers can be found under
+              /var/log/containers/ceilometer.
+          ignore_errors: true
       upgrade_tasks:
         - name: Check if ceilometer_agent_central is deployed
           command: systemctl is-enabled --quiet openstack-ceilometer-central

docker/services/ceilometer-agent-compute.yaml

@@ -103,6 +103,13 @@ outputs:
           file:
             path: /var/log/containers/ceilometer
             state: directory
+        - name: ceilometer logs readme
+          copy:
+            dest: /var/log/ceilometer/readme.txt
+            content: |
+              Log files from ceilometer containers can be found under
+              /var/log/containers/ceilometer.
+          ignore_errors: true
       upgrade_tasks:
         - name: Check if openstack-ceilometer-compute is deployed
           command: systemctl is-enabled --quiet openstack-ceilometer-compute

docker/services/ceilometer-agent-ipmi.yaml

@@ -111,6 +111,13 @@ outputs:
           file:
             path: /var/log/containers/ceilometer
             state: directory
+        - name: ceilometer logs readme
+          copy:
+            dest: /var/log/ceilometer/readme.txt
+            content: |
+              Log files from ceilometer containers can be found under
+              /var/log/containers/ceilometer.
+          ignore_errors: true
       upgrade_tasks:
         - name: Check if ceilometer-agent-ipmi is deployed
           command: systemctl is-enabled --quiet openstack-ceilometer-ipmi

docker/services/ceilometer-agent-notification.yaml

@@ -121,6 +121,13 @@ outputs:
           file:
             path: /var/log/containers/ceilometer
             state: directory
+        - name: ceilometer logs readme
+          copy:
+            dest: /var/log/ceilometer/readme.txt
+            content: |
+              Log files from ceilometer containers can be found under
+              /var/log/containers/ceilometer.
+          ignore_errors: true
       upgrade_tasks:
         - name: Check if ceilometer_agent_notification is deployed
           command: systemctl is-enabled --quiet openstack-ceilometer-notification

docker/services/cinder-api.yaml

@@ -193,6 +193,13 @@ outputs:
           with_items:
             - /var/log/containers/cinder
             - /var/log/containers/httpd/cinder-api
+        - name: cinder logs readme
+          copy:
+            dest: /var/log/cinder/readme.txt
+            content: |
+              Log files from cinder containers can be found under
+              /var/log/containers/cinder and /var/log/containers/httpd/cinder-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable cinder_api service
           tags: step2

docker/services/cinder-backup.yaml

@@ -144,6 +144,13 @@ outputs:
           with_items:
             - /var/lib/cinder
             - /var/log/containers/cinder
+        - name: cinder logs readme
+          copy:
+            dest: /var/log/cinder/readme.txt
+            content: |
+              Log files from cinder containers can be found under
+              /var/log/containers/cinder and /var/log/containers/httpd/cinder-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/cinder-scheduler.yaml

@@ -124,6 +124,13 @@ outputs:
             state: directory
           with_items:
             - /var/log/containers/cinder
+        - name: cinder logs readme
+          copy:
+            dest: /var/log/cinder/readme.txt
+            content: |
+              Log files from cinder containers can be found under
+              /var/log/containers/cinder and /var/log/containers/httpd/cinder-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable cinder_scheduler service
           tags: step2

docker/services/cinder-volume.yaml

@@ -155,6 +155,13 @@ outputs:
           with_items:
             - /var/log/containers/cinder
             - /var/lib/cinder
+        - name: cinder logs readme
+          copy:
+            dest: /var/log/cinder/readme.txt
+            content: |
+              Log files from cinder containers can be found under
+              /var/log/containers/cinder and /var/log/containers/httpd/cinder-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/collectd.yaml

@@ -112,6 +112,13 @@ outputs:
           file:
             path: /var/log/containers/collectd
             state: directory
+        - name: collectd logs readme
+          copy:
+            dest: /var/log/collectd/readme.txt
+            content: |
+              Log files from collectd containers can be found under
+              /var/log/containers/collectd.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable collectd service
           tags: step2

docker/services/congress.yaml

@@ -141,6 +141,13 @@ outputs:
           file:
             path: /var/log/containers/congress
             state: directory
+        - name: congress logs readme
+          copy:
+            dest: /var/log/congress/readme.txt
+            content: |
+              Log files from congress containers can be found under
+              /var/log/containers/congress.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable congress_api service
           tags: step2

docker/services/database/mongodb.yaml

@@ -156,6 +156,13 @@ outputs:
           with_items:
             - /var/log/containers/mongodb
             - /var/lib/mongodb
+        - name: mongodb logs readme
+          copy:
+            dest: /var/log/mongodb/readme.txt
+            content: |
+              Log files from mongodb containers can be found under
+              /var/log/containers/mongodb.
+          ignore_errors: true
       metadata_settings:
         get_attr: [MongodbPuppetBase, role_data, metadata_settings]
       upgrade_tasks:

docker/services/database/mysql.yaml

@@ -228,6 +228,13 @@ outputs:
           with_items:
             - /var/log/containers/mysql
             - /var/lib/mysql
+        - name: mysql logs readme
+          copy:
+            dest: /var/log/mariadb/readme.txt
+            content: |
+              Log files from mysql containers can be found under
+              /var/log/containers/mysql.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable mysql service
           tags: step2

docker/services/database/redis.yaml

@@ -156,6 +156,13 @@ outputs:
           with_items:
             - /var/log/containers/redis
             - /var/run/redis
+        - name: redis logs readme
+          copy:
+            dest: /var/log/redis/readme.txt
+            content: |
+              Log files from redis containers can be found under
+              /var/log/containers/redis.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable redis service
           tags: step2

docker/services/ec2-api.yaml

@@ -161,6 +161,16 @@ outputs:
           with_items:
             - ec2_api
             - ec2_api_metadata
+        - name: ec2_api logs readme
+          copy:
+            dest: /var/log/{{ item }}/readme.txt
+            content: |
+              Log files from ec2api containers can be found under
+              /var/log/containers/ec2_api and /var/log/containers/ec2_api_metadata.
+            with_items:
+              - ec2api
+              - ec2api-metadata
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable EC2-API services
           tags: step2

docker/services/fluentd-client.yaml

@@ -110,6 +110,13 @@ outputs:
           file:
             path: /var/log/containers/fluentd
             state: directory
+        - name: fluentd logs readme
+          copy:
+            dest: /var/log/fluentd/readme.txt
+            content: |
+              Log files from fluentd containers can be found under
+              /var/log/containers/fluentd.
+          ignore_errors: true
         - name: create persistent cache directory
           file:
             path: /var/cache/containers/fluentd

docker/services/gnocchi-api.yaml

@@ -164,6 +164,13 @@ outputs:
           with_items:
             - /var/log/containers/gnocchi
             - /var/log/containers/httpd/gnocchi-api
+        - name: gnocchi logs readme
+          copy:
+            dest: /var/log/gnocchi/readme.txt
+            content: |
+              Log files from gnocchi containers can be found under
+              /var/log/containers/gnocchi and /var/log/containers/httpd/gnocchi-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/gnocchi-metricd.yaml

@@ -113,6 +113,13 @@ outputs:
           file:
             path: /var/log/containers/gnocchi
             state: directory
+        - name: gnocchi logs readme
+          copy:
+            dest: /var/log/gnocchi/readme.txt
+            content: |
+              Log files from gnocchi containers can be found under
+              /var/log/containers/gnocchi and /var/log/containers/httpd/gnocchi-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/gnocchi-statsd.yaml

@@ -113,6 +113,13 @@ outputs:
           file:
             path: /var/log/containers/gnocchi
             state: directory
+        - name: gnocchi logs readme
+          copy:
+            dest: /var/log/gnocchi/readme.txt
+            content: |
+              Log files from gnocchi containers can be found under
+              /var/log/containers/gnocchi and /var/log/containers/httpd/gnocchi-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/horizon.yaml

@@ -158,6 +158,13 @@ outputs:
           with_items:
             - /var/log/containers/horizon
             - /var/log/containers/httpd/horizon
+        - name: horizon logs readme
+          copy:
+            dest: /var/log/horizon/readme.txt
+            content: |
+              Log files from horizon containers can be found under
+              /var/log/containers/horizon and /var/log/containers/httpd/horizon.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable horizon service (running under httpd)
           tags: step2

docker/services/ironic-api.yaml

@@ -144,6 +144,13 @@ outputs:
           with_items:
             - /var/log/containers/ironic
             - /var/log/containers/httpd/ironic-api
+        - name: ironic logs readme
+          copy:
+            dest: /var/log/ironic/readme.txt
+            content: |
+              Log files from ironic containers can be found under
+              /var/log/containers/ironic and /var/log/containers/httpd/ironic-*.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable ironic_api service
           tags: step2

docker/services/ironic-conductor.yaml

@@ -132,6 +132,13 @@ outputs:
           with_items:
             - /var/log/containers/ironic
             - /var/lib/ironic
+        - name: ironic logs readme
+          copy:
+            dest: /var/log/ironic/readme.txt
+            content: |
+              Log files from ironic containers can be found under
+              /var/log/containers/ironic and /var/log/containers/httpd/ironic-*.
+          ignore_errors: true
         - name: stat /httpboot
           stat: path=/httpboot
           register: stat_httpboot

docker/services/ironic-inspector.yaml

@@ -164,6 +164,13 @@ outputs:
           file:
             path: /var/log/containers/ironic-inspector
             state: directory
+        - name: ironic-inspector logs readme
+          copy:
+            dest: /var/log/ironic-inspector/readme.txt
+            content: |
+              Log files from ironic-inspector container can be found under
+              /var/log/containers/ironic-inspector.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable ironic_inspector service
           tags: step2

docker/services/ironic-pxe.yaml

@@ -123,3 +123,10 @@ outputs:
             - /var/lib/ironic
             - /var/log/containers/ironic
             - /var/log/containers/httpd/ironic-pxe
+        - name: ironic logs readme
+          copy:
+            dest: /var/log/ironic/readme.txt
+            content: |
+              Log files from ironic containers can be found under
+              /var/log/containers/ironic and /var/log/containers/httpd/ironic-*.
+          ignore_errors: true

docker/services/logging/files/glance-api.yaml

@@ -38,3 +38,10 @@ outputs:
         with_items:
           - /var/log/containers/glance
           - /var/log/containers/httpd/glance-api
+      - name: glance logs readme
+        copy:
+          dest: /var/log/glance/readme.txt
+          content: |
+            Log files from glance containers can be found under
+            /var/log/containers/glance and /var/log/containers/httpd/glance-api.
+        ignore_errors: true

docker/services/logging/files/heat-api-cfn.yaml

@@ -26,3 +26,10 @@ outputs:
         with_items:
           - /var/log/containers/heat
           - /var/log/containers/httpd/heat-api-cfn
+      - name: heat logs readme
+        copy:
+          dest: /var/log/heat/readme.txt
+          content: |
+            Log files from heat containers can be found under
+            /var/log/containers/heat and /var/log/containers/httpd/heat-api*.
+        ignore_errors: true

docker/services/logging/files/heat-api.yaml

@@ -26,3 +26,10 @@ outputs:
         with_items:
           - /var/log/containers/heat
           - /var/log/containers/httpd/heat-api
+      - name: heat logs readme
+        copy:
+          dest: /var/log/heat/readme.txt
+          content: |
+            Log files from heat containers can be found under
+            /var/log/containers/heat and /var/log/containers/httpd/heat-api*.
+        ignore_errors: true

docker/services/logging/files/heat-engine.yaml

@@ -37,3 +37,10 @@ outputs:
         file:
           path: /var/log/containers/heat
           state: directory
+      - name: heat logs readme
+        copy:
+          dest: /var/log/heat/readme.txt
+          content: |
+            Log files from heat containers can be found under
+            /var/log/containers/heat and /var/log/containers/httpd/heat-api*.
+        ignore_errors: true

docker/services/logging/files/keystone.yaml

@@ -40,3 +40,10 @@ outputs:
         with_items:
           - /var/log/containers/keystone
           - /var/log/containers/httpd/keystone
+      - name: keystone logs readme
+        copy:
+          dest: /var/log/keystone/readme.txt
+          content: |
+            Log files from keystone containers can be found under
+            /var/log/containers/keystone and /var/log/containers/httpd/keystone.
+        ignore_errors: true

docker/services/logging/files/neutron-api.yaml

@@ -38,3 +38,10 @@ outputs:
         with_items:
           - /var/log/containers/neutron
           - /var/log/containers/httpd/neutron-api
+      - name: neutron logs readme
+        copy:
+          dest: /var/log/neutron/readme.txt
+          content: |
+            Log files from neutron containers can be found under
+            /var/log/containers/neutron and /var/log/containers/httpd/neutron-api.
+        ignore_errors: true

docker/services/logging/files/neutron-common.yaml

@@ -24,3 +24,10 @@ outputs:
           state: directory
         with_items:
           - /var/log/containers/neutron
+      - name: neutron logs readme
+        copy:
+          dest: /var/log/neutron/readme.txt
+          content: |
+            Log files from neutron containers can be found under
+            /var/log/containers/neutron and /var/log/containers/httpd/neutron-api.
+        ignore_errors: true

docker/services/logging/files/nova-api.yaml

@@ -38,3 +38,10 @@ outputs:
         with_items:
           - /var/log/containers/nova
           - /var/log/containers/httpd/nova-api
+      - name: nova logs readme
+        copy:
+          dest: /var/log/nova/readme.txt
+          content: |
+            Log files from nova containers can be found under
+            /var/log/containers/nova and /var/log/containers/httpd/nova-*.
+        ignore_errors: true

docker/services/logging/files/nova-common.yaml

@@ -55,3 +55,10 @@ outputs:
         file:
           path: /var/log/containers/nova
           state: directory
+      - name: nova logs readme
+        copy:
+          dest: /var/log/nova/readme.txt
+          content: |
+            Log files from nova containers can be found under
+            /var/log/containers/nova and /var/log/containers/httpd/nova-*.
+        ignore_errors: true

docker/services/logging/files/nova-placement.yaml

@@ -37,3 +37,10 @@ outputs:
         with_items:
           - /var/log/containers/nova
           - /var/log/containers/httpd/nova-placement
+      - name: nova logs readme
+        copy:
+          dest: /var/log/nova/readme.txt
+          content: |
+            Log files from nova containers can be found under
+            /var/log/containers/nova and /var/log/containers/httpd/nova-*.
+        ignore_errors: true

docker/services/logging/files/panko-api.yaml

@@ -39,3 +39,10 @@ outputs:
         with_items:
           - /var/log/containers/panko
           - /var/log/containers/httpd/panko-api
+      - name: panko logs readme
+        copy:
+          dest: /var/log/panko/readme.txt
+          content: |
+            Log files from panko containers can be found under
+            /var/log/containers/panko and /var/log/containers/httpd/panko-api.
+        ignore_errors: true

docker/services/manila-api.yaml

@@ -131,6 +131,13 @@ outputs:
           with_items:
             - /var/log/containers/manila
             - /var/log/containers/httpd/manila-api
+        - name: manila logs readme
+          copy:
+            dest: /var/log/manila/readme.txt
+            content: |
+              Log files from manila containers can be found under
+              /var/log/containers/manila and /var/log/containers/httpd/manila-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable manila_api service
           tags: step2

docker/services/manila-scheduler.yaml

@@ -107,6 +107,13 @@ outputs:
           file:
             path: /var/log/containers/manila
             state: directory
+        - name: manila logs readme
+          copy:
+            dest: /var/log/manila/readme.txt
+            content: |
+              Log files from manila containers can be found under
+              /var/log/containers/manila and /var/log/containers/httpd/manila-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable manila_scheduler service
           tags: step2

docker/services/manila-share.yaml

@@ -112,6 +112,13 @@ outputs:
           file:
             path: /var/log/containers/manila
             state: directory
+        - name: manila logs readme
+          copy:
+            dest: /var/log/manila/readme.txt
+            content: |
+              Log files from manila containers can be found under
+              /var/log/containers/manila and /var/log/containers/httpd/manila-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/memcached.yaml

@@ -108,6 +108,12 @@ outputs:
           file:
             path: /var/log/containers/memcached
             state: directory
+        - name: memcached logs readme
+          copy:
+            dest: /var/log/memcached-readme.txt
+            content: |
+              Log files from memcached containers can be found under
+              /var/log/containers/memcached.
       upgrade_tasks:
         - name: Stop and disable memcached service
           tags: step2

docker/services/mistral-api.yaml

@@ -186,6 +186,13 @@ outputs:
           file:
             path: /var/log/containers/mistral
             state: directory
+        - name: mistral logs readme
+          copy:
+            dest: /var/log/mistral/readme.txt
+            content: |
+              Log files from mistral containers can be found under
+              /var/log/containers/mistral.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable mistral_api service
           tags: step2

docker/services/mistral-engine.yaml

@@ -114,6 +114,13 @@ outputs:
           file:
             path: /var/log/containers/mistral
             state: directory
+        - name: mistral logs readme
+          copy:
+            dest: /var/log/mistral/readme.txt
+            content: |
+              Log files from mistral containers can be found under
+              /var/log/containers/mistral.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable mistral_engine service
           tags: step2

docker/services/mistral-event-engine.yaml

@@ -112,6 +112,13 @@ outputs:
           file:
             path: /var/log/containers/mistral
             state: directory
+        - name: mistral logs readme
+          copy:
+            dest: /var/log/mistral/readme.txt
+            content: |
+              Log files from mistral containers can be found under
+              /var/log/containers/mistral.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable mistral_event_engine service
           tags: step2

docker/services/mistral-executor.yaml

@@ -118,6 +118,13 @@ outputs:
           file:
             path: /var/log/containers/mistral
             state: directory
+        - name: mistral logs readme
+          copy:
+            dest: /var/log/mistral/readme.txt
+            content: |
+              Log files from mistral containers can be found under
+              /var/log/containers/mistral.
+          ignore_errors: true
       upgrade_tasks:
         - name: Check if mistral executor is deployed
           command: systemctl is-enabled openstack-mistral-executor

docker/services/nova-ironic.yaml

@@ -123,6 +123,13 @@ outputs:
           with_items:
             - /var/log/containers/nova
             - /var/lib/nova
+        - name: nova logs readme
+          copy:
+            dest: /var/log/nova/readme.txt
+            content: |
+              Log files from nova containers can be found under
+              /var/log/containers/nova and /var/log/containers/httpd/nova-*.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable nova-compute service
           tags: step2

docker/services/octavia-api.yaml

@@ -176,6 +176,13 @@ outputs:
           with_items:
             - /var/log/containers/octavia
             - /var/log/containers/httpd/octavia-api
+        - name: octavia logs readme
+          copy:
+            dest: /var/log/octavia/readme.txt
+            content: |
+              Log files from octavia containers can be found under
+              /var/log/containers/octavia and /var/log/containers/httpd/octavia-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable octavia_api service
           tags: step2

docker/services/octavia-health-manager.yaml

@@ -118,6 +118,13 @@ outputs:
           file:
             path: /var/log/containers/octavia
             state: directory
+        - name: octavia logs readme
+          copy:
+            dest: /var/log/octavia/readme.txt
+            content: |
+              Log files from octavia containers can be found under
+              /var/log/containers/octavia and /var/log/containers/httpd/octavia-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable octavia_health_manager service
           tags: step2

docker/services/octavia-housekeeping.yaml

@@ -114,6 +114,13 @@ outputs:
           file:
             path: /var/log/containers/octavia
             state: directory
+        - name: octavia logs readme
+          copy:
+            dest: /var/log/octavia/readme.txt
+            content: |
+              Log files from octavia containers can be found under
+              /var/log/containers/octavia and /var/log/containers/httpd/octavia-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable octavia_housekeeping service
           tags: step2

docker/services/octavia-worker.yaml

@@ -114,6 +114,13 @@ outputs:
           file:
             path: /var/log/containers/octavia
             state: directory
+        - name: octavia logs readme
+          copy:
+            dest: /var/log/octavia/readme.txt
+            content: |
+              Log files from octavia containers can be found under
+              /var/log/containers/octavia and /var/log/containers/httpd/octavia-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable octavia_worker service
           tags: step2

docker/services/opendaylight-api.yaml

@@ -115,6 +115,13 @@ outputs:
             - /var/log/containers/opendaylight
             - /var/lib/opendaylight/snapshots
             - /var/lib/opendaylight/journal
+        - name: opendaylight logs readme
+          copy:
+            dest: /var/log/opendaylight/readme.txt
+            content: |
+              Log files from opendaylight containers can be found under
+              /var/log/containers/opendaylight.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable opendaylight_api service
           tags: step2

docker/services/ovn-controller.yaml

@@ -106,6 +106,13 @@ outputs:
           file:
             path: /var/log/containers/openvswitch
             state: directory
+        - name: openvswitch logs readme
+          copy:
+            dest: /var/log/openvswitch/readme.txt
+            content: |
+              Log files from openvswitch containers can be found under
+              /var/log/containers/openvswitch.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable ovn-controller service
           tags: step2

docker/services/ovn-dbs.yaml

@@ -198,6 +198,13 @@ outputs:
           with_items:
             - /var/log/containers/openvswitch
             - /var/lib/openvswitch/ovn
+        - name: openvswitch logs readme
+          copy:
+            dest: /var/log/openvswitch/readme.txt
+            content: |
+              Log files from openvswitch containers can be found under
+              /var/log/containers/openvswitch.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable ovn-northd service
           tags: step2

docker/services/pacemaker/cinder-backup.yaml

@@ -189,6 +189,13 @@ outputs:
           with_items:
             - /var/lib/cinder
             - /var/log/containers/cinder
+        - name: cinder logs readme
+          copy:
+            dest: /var/log/cinder/readme.txt
+            content: |
+              Log files from cinder containers can be found under
+              /var/log/containers/cinder and /var/log/containers/httpd/cinder-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/pacemaker/cinder-volume.yaml

@@ -182,6 +182,13 @@ outputs:
           with_items:
             - /var/log/containers/cinder
             - /var/lib/cinder
+        - name: cinder logs readme
+          copy:
+            dest: /var/log/cinder/readme.txt
+            content: |
+              Log files from cinder containers can be found under
+              /var/log/containers/cinder and /var/log/containers/httpd/cinder-api.
+          ignore_errors: true
         - name: ensure ceph configurations exist
           file:
             path: /etc/ceph

docker/services/pacemaker/manila-share.yaml

@@ -162,6 +162,13 @@ outputs:
           with_items:
             - /var/log/containers/manila
             - /var/lib/manila
+        - name: manila logs readme
+          copy:
+            dest: /var/log/manila/readme.txt
+            content: |
+              Log files from manila containers can be found under
+              /var/log/containers/manila and /var/log/containers/httpd/manila-api.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable manila_share service
           tags: step2

docker/services/pacemaker/ovn-dbs.yaml

@@ -136,6 +136,13 @@ outputs:
           with_items:
             - /var/log/containers/openvswitch
             - /var/lib/openvswitch/ovn
+        - name: openvswitch logs readme
+          copy:
+            dest: /var/log/openvswitch/readme.txt
+            content: |
+              Log files from openvswitch containers can be found under
+              /var/log/containers/openvswitch.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable ovn-northd service
           tags: step2

docker/services/qdrouterd.yaml

@@ -115,5 +115,12 @@ outputs:
         with_items:
           - /var/log/containers/qdrouterd
           - /var/lib/qdrouterd
+      - name: qrouterd logs readme
+        copy:
+          dest: /var/log/qrouterd/readme.txt
+          content: |
+            Log files from qrouterd containers can be found under
+            /var/log/containers/qrouterd.
+        ignore_errors: true
       metadata_settings:
         get_attr: [QdrouterdBase, role_data, metadata_settings]

docker/services/rabbitmq.yaml

@@ -218,6 +218,13 @@ outputs:
           with_items:
             - /var/log/containers/rabbitmq
             - /var/lib/rabbitmq
+        - name: rabbitmq logs readme
+          copy:
+            dest: /var/log/rabbitmq/readme.txt
+            content: |
+              Log files from rabbitmq containers can be found under
+              /var/log/containers/rabbitmq.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable rabbitmq service
           tags: step2

docker/services/sahara-api.yaml

@@ -138,6 +138,13 @@ outputs:
           file:
             path: /var/log/containers/sahara
             state: directory
+        - name: sahara logs readme
+          copy:
+            dest: /var/log/sahara/readme.txt
+            content: |
+              Log files from sahara containers can be found under
+              /var/log/containers/sahara.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable sahara_api service
           tags: step2

docker/services/sahara-engine.yaml

@@ -123,6 +123,13 @@ outputs:
           file:
             path: /var/log/containers/sahara
             state: directory
+        - name: sahara logs readme
+          copy:
+            dest: /var/log/sahara/readme.txt
+            content: |
+              Log files from sahara containers can be found under
+              /var/log/containers/sahara.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable sahara_engine service
           tags: step2

docker/services/sensu-client.yaml

@@ -146,6 +146,13 @@ outputs:
           file:
             path: /var/log/containers/sensu
             state: directory
+        - name: sensu logs readme
+          copy:
+            dest: /var/log/sensu/readme.txt
+            content: |
+              Log files from sensu containers can be found under
+              /var/log/containers/sensu.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable sensu-client service
           tags: step2

docker/services/swift-proxy.yaml

@@ -149,6 +149,13 @@ outputs:
             - /var/log/containers/swift
             - /var/log/containers/httpd/swift-proxy
             - /srv/node
+        - name: swift logs readme
+          copy:
+            dest: /var/log/swift/readme.txt
+            content: |
+              Log files from swift containers can be found under
+              /var/log/containers/swift and /var/log/containers/httpd/swift-*.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable swift_proxy service
           tags: step2

docker/services/swift-storage.yaml

@@ -450,6 +450,13 @@ outputs:
           with_items:
             - /var/log/containers/swift
             - /srv/node
+        - name: swift logs readme
+          copy:
+            dest: /var/log/swift/readme.txt
+            content: |
+              Log files from swift containers can be found under
+              /var/log/containers/swift and /var/log/containers/httpd/swift-*.
+          ignore_errors: true
         - name: Format and mount devices defined in SwiftRawDisks
           mount:
             name: /srv/node/{{ item }}

docker/services/tacker.yaml

@@ -136,6 +136,13 @@ outputs:
           file:
             path: /var/log/containers/tacker
             state: directory
+        - name: tacker logs readme
+          copy:
+            dest: /var/log/tacker/readme.txt
+            content: |
+              Log files from tacker containers can be found under
+              /var/log/containers/tacker.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable tacker-server service
           tags: step2

docker/services/zaqar.yaml

@@ -188,6 +188,13 @@ outputs:
           with_items:
             - /var/log/containers/zaqar
             - /var/log/containers/httpd/zaqar
+        - name: zaqar logs readme
+          copy:
+            dest: /var/log/zaqar/readme.txt
+            content: |
+              Log files from zaqar containers can be found under
+              /var/log/containers/zaqar and /var/log/containers/httpd/zaqar.
+          ignore_errors: true
       upgrade_tasks:
         - name: Stop and disable zaqar service
           tags: step2