container system property subcommand missing?

[phoward8020]

I just installed (via brew) and am trying to follow the tutorial.

I got to the section on local DNS domain setup and was able to create a local domain using the first command provided, but the second command--to set that new domain as the default--fails.

> container system property set dns.domain test
Error: 4 unexpected arguments: 'property', 'set', 'dns.domain', 'test'
Usage: container system <subcommand>
  See 'container system --help' for more information.

Running container system --help, I can see that there is in fact no subcommand called property.

> container system --help
OVERVIEW: Manage system components

USAGE: container system <subcommand>

OPTIONS:
  --version               Show the version.
  -h, --help              Show help information.

SUBCOMMANDS:
  dns                     Manage local DNS domains
  logs                    Fetch system logs for `container` services
  start                   Start `container` services
  stop                    Stop all `container` services
  status                  Show the status of `container` services
  kernel                  Manage the default kernel configuration

  See 'container help system <subcommand>' for detailed help.

I was able to puzzle out that container system dns default set test does work, so I naturally thought about submitting a PR to update the doc, but then I saw that it had already been updated recently to replace the command that does work with the one that doesn't.

So I guess my question is: what exactly is this noob missing?

[katiewasnothere]

Hi @phoward8020! Basically what's happening is that we've been making breaking changes in the CLI. You've installed container with brew at version 0.4.1, which was released at the end of last month, but the tutorial you're looking at lives on the main branch, which means it has the most recent changes that will be in the next release. We typically make new releases at the end of the month, so there should be a new release in the next week that has the container system property subcommand.

Since we've had a few questions about this, we opened an issue here #638 tracking trying to make it easier to find the right documentation for the installed version of the tool. I recently merged this change #676 to add a note in the README warning users to make sure they're looking at the right version of the docs. If you have any thoughts on how we can make this warning more obvious, please feel free to let us know or open a PR to make the changes. Thanks!

[phoward8020]

Cool, thanks for the quick response. :-)

Edit: for anyone in the same boat as me, here's the link to the correct version of the tutorial: https://github.com/apple/container/blob/0.4.1/docs/tutorial.md