Warning and refresh even with no configs in the class declaration

[ubellavance]

Hi,

I have absolutely nothing in my class, but I'm still getting hte warning to put everything in Hiera (which I do).

My class declaration:

class profile::rpnginx  {

  class { 'nginx':  }

}

The warning. As you can see, the URL should be updated to voxpopuli

Notice: [nginx] *** DEPRECATION WARNING***: HI! I notice that you're declaring some attributes in Class[nginx]. It is highly recommended to set these values via Hiera going forward. This will become mandatory in the near future. Please check out https://github.com/jfryman/puppet-nginx/blob/master/docs/hiera.md for more information.
Notice: /Stage[main]/Nginx::Notice::Config/Notify[[nginx] *** DEPRECATION WARNING***: HI! I notice that you're declaring some attributes in Class[nginx]. It is highly recommended to set these values via Hiera going forward. This will become mandatory in the near future. Please check out https://github.com/jfryman/puppet-nginx/blob/master/docs/hiera.md for more information.]/message: defined 'message' as '[nginx] *** DEPRECATION WARNING***: HI! I notice that you're declaring some attributes in Class[nginx]. It is highly recommended to set these values via Hiera going forward. This will become mandatory in the near future. Please check out https://github.com/jfryman/puppet-nginx/blob/master/docs/hiera.md for more information.'
Notice: Finished catalog run in 1.83 seconds

Thanks,

[wyardley]

In that simple example, do you have nginx::config defined in hiera? If not, try using something like the (clunky-looking, but working) example at:
https://github.com/voxpupuli/puppet-nginx/blob/master/docs/hiera.md

I think the problem is that if you don't declare nginx::config at all, the module still sets some default values for it. If you are setting some config variables in hiera, it is odd that you're seeing that warning.

As far as the outdated URL, I'll update it.

[ubellavance]

Yes I do have many nginx::config in hiera:

# grep nginx::config /etc/puppet/hiera/host/server.example.com.yaml | grep -v ^#
nginx::config::http_cfg_append:
nginx::config::conf_dir: '/etc/opt/rh/rh-nginx18/nginx'
nginx::config::client_body_temp_path: '/var/opt/rh/rh-nginx18/lib/nginx/tmp/client_body'
nginx::config::proxy_temp_path: '/var/opt/rh/rh-nginx18/lib/nginx/tmp/proxy'
nginx::config::vhost_purge: true
nginx::config::confd_purge: true
nginx::config::log_dir: '/var/opt/rh/rh-nginx18/log/nginx'
nginx::config::gzip_types: 'text/plain text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript'

Unless you meant just nginx::config. If that is the case, I don't know exactly what you'd mean.

[wyardley]

Just out of curiosity, if you do include nginx instead of class { nginx: }, do you still get the warning?

Based on the link above, I think you need to use that clunkier example (with the anchor block) to define it that way.

[ubellavance]

Still getting the warning using include nginx.

[wyardley]

Are you setting nginx::foo in hiera?

If you're setting any of the parameters I mentioned in #895 in nginx::XX, that's probably why you're getting that deprecation warning. Setting them in hiera is more or less equivalent to declaring the class with them.

I've tried a pretty vanilla setup both using Hiera and not, both with Puppet 3 and 4, and haven't seen this warning.

[ubellavance]

Yes, I set many nginx::foo in Hiera, since I'm using the nginx package from Red Hat Sofware Collections, which uses unusual paths (and I also have non-standard requirements):

nginx::worker_processes: 'auto'
nginx::manage_repo: false
nginx::package_name: 'rh-nginx18-nginx'
nginx::pid: '/var/opt/rh/rh-nginx18/run/nginx/nginx.pid'
nginx::http_access_log: '/var/opt/rh/rh-nginx18/log/nginx/access.log'
nginx::nginx_error_log: '/var/opt/rh/rh-nginx18/log/nginx/error.log'
nginx::service_name: 'rh-nginx18-nginx'
nginx::service::service_restart: '/opt/rh/rh-nginx18/root/usr/sbin/nginx -t && systemctl reload rh-nginx18-nginx.service'
nginx::server_tokens: 'off'
nginx::log_format:
nginx::proxy_connect_timeout: '5400'
nginx::proxy_read_timeout:    '5400'
nginx::proxy_send_timeout:    '5400'
nginx::proxy_hide_header:
nginx::proxy_set_header:
nginx::nginx_vhosts:
nginx::nginx_locations:

[wyardley]

If you're declaring nginx::foo in hiera, you don't have "absolutely nothing in my class"; you're just declaring it in hiera instead of in the manifest.

I showed you the sections of code with the parameters for nginx::config; anything in there that's currently in nginx:: should be moved. Basically, anything that's configuring nginx (vs. configuring how the module configures it or manages the service) is in nginx::config currently.

If you want to think of it differently, move everything to nginx::config and then take any parameters in these lines (or just change them all and see which ones fail):
https://github.com/voxpupuli/puppet-nginx/blob/master/manifests/init.pp#L105-L130
back to nginx::.

Yes, the docs are terrible, but with the information I gave you earlier, you should be able to update your hiera configs as needed.

[ubellavance]

Ok, so it is normal that the current code is not consistent with the philosophy. Work in progress I guess. I can understand, no problem then. I don't have enough knowledge to contribute for that so I'll concentrate on other areas. Thanks,

[wyardley]

Not sure I follow?

I think the existing code, while hard to read, is more or less consistent with the direction the previous maintainer was taking. While you can use some of the configuration directives at the top level, you will get a deprecation warning if you do it.

The nginx::nginx_vhosts and nginx::locations ones are probably an exception because they're so commonly used, but all the general config directives would go in config.

Is there a reason you're going to so much work to configure it to use the SCL version of nginx? If you just need a newer nginx, if you let the module manage the package, you'll get 1.10 or 1.11 on most platforms with a lot less fuss....

[wyardley]

This appears to be functioning as intended (the deprecation warning is appearing because params that were moved to nginx::config are being called via nginx::. I'm going to close out that issue; the docs issues and general structural issues are known and are being addressed elsewhere.

[ubellavance]

Ok, I see. My primary goal is to make sure that it works, not avoid the warning. Are you meaning that either should work? This is not what I experimented...

The reason for using the SCL version of nginx is to get support directly from Red Hat through our subscription. On Red Hat Enterprise Linux, nginx is not available in the base distro. It is available through EPEL, SCL, or Nginx's repo, but only SCL versions are supported by Red Hat support. Considering that I begin with nginx, that I have many non-standard requirements and the very good support at Red Hat, I don't mind putting the extra effort to use the SCL version. As a side effect, it helps testing this module with special parameters.

[wyardley]

Yes, fixing the warnings is safest, and will also make your configs more consistent.
So, at this point, do you understand how to tell which parameters are in which namespace?

[ubellavance]

I understand that many, if not all parameters can be called from any of the two namespaces, but if the nginx:: namespase is used instead of nginx::config, it throws a warning but it works. I'll try to clean up my params so that the warning disappears, especially since I'd like to use my hiera files as examples for this module's documentation. The goal of most of the issues I have created is to make sure that I understand the module correctly so that I can contribute, at least for documentation.