Refactor: scheduler: best practices for get_container_list()

Rename get_container_list() to pcmk__bundle_containers(), expose it as
library-private for future reuse, add a doxygen block, and improve
variable names and formatting.

Also, just assume variant is bundle rather than checking, so it asserts if
called with a different variant.