action :delete & action :destroy

[matiasdecarli]

Reading the docs, I can see that "delete" is a option for the machine resource

But when I use it

  Chef::Exceptions::ValidationFailed
  ----------------------------------
  Option action must be equal to one of: nothing, allocate, ready, setup, converge, converge_only, destroy, stop!  You passed :delete.

  Cookbook Trace:
  ---------------
    /home/vagrant/cookbooks/matiasdecarli/recipes/create_container.rb:55:in `block in from_file'
    /home/vagrant/cookbooks/matiasdecarli/recipes/create_container.rb:52:in `from_file'

  Relevant File Content:
  ----------------------
  /home/vagrant/cookbooks/matiasdecarli/recipes/create_container.rb:

   50:  
   51:  machine "deploy-to-delete" do
   52>>   action :delete
   53:  end
   54: 

Am I doing something wrong here? I can use destroy, but this doesnt delete the node, only the container. Thanks in advance

[johnewart]

Apparently we don't have delete as a supported action in the metal machine resource... I'll tag this as a bug for 1.0; should be an easy fix.

[jkeiser]

This should be a doc fix.

[esciara]

Hi there. Came across this problem and it does not feel safe that the doc does actually not reflect the really. Looks like this a fairly widespread problem. I feel it has been quite some effort to figure out how things work, and absence/wrongness of doc has not helped.

Trying to put a constructive spin to this: is there any way that the doc could be generated from the code, just to make sure it is up to date?

[jkeiser]

This is fixed. https://docs.chef.io/resource_machine.html#actions

As for autogenerating docs, it's definitely on a list. Will take some sphinxing though. @jamescott and I have talked about it, but we haven't got to it yet.