metalctlv2_machine_create.md

metalctlv2 machine create

creates the machine

metalctlv2 machine create [flags]

Options

      --allocation-type string     allocation type, can be either machine|firewall (default "machine")
      --bulk-output                when used with --file (bulk operation): prints results at the end as a list. default is printing results intermediately during the operation, which causes single entities to be printed in a row.
      --description string         Description of the machine to create. [optional]
      --dns-servers strings        dns servers to add to the machine or firewall. [optional]
  -f, --file string                filename of the create or update request in yaml format, or - for stdin.
                                   
                                   Example:
                                   $ metalctlv2 machine describe machine-1 -o yaml > machine.yaml
                                   $ vi machine.yaml
                                   $ # either via stdin
                                   $ cat machine.yaml | metalctlv2 machine create -f -
                                   $ # or via file
                                   $ metalctlv2 machine create -f machine.yaml
                                   
                                   the file can also contain multiple documents and perform a bulk operation.
                                   	
      --filesystem-layout string   Filesystemlayout to use during machine installation. [optional]
  -h, --help                       help for create
      --hostname string            Hostname of the machine. [required]
      --image string               OS Image to install. [required]
      --labels strings             labels to add to the machine, use it like: --labels "a=b" or --labels "a=".
      --name string                Name of the machine. [optional]
      --networks strings           Adds a network. Usage: [--networks NETWORK[:ip[;ip]][,NETWORK[:ip[;ip]]...
                                   NETWORK specifies the name or id of an existing network.
                                   IPs can be added per network colon separated, these ips must be already allocated upfront. If no ip(s) are specified per network, one ip per network is allocated.
                                   
      --ntp-servers strings        ntp servers to add to the machine or firewall. [optional]
      --partition string           partition/datacenter where the machine is created. [required, except for reserved machines]
      --placement-labels strings   placement tags used for rack spreading
  -p, --project string             Project where the machine should belong to. [required]
      --size string                Size of the machine. [required, except for reserved machines]
      --skip-security-prompts      skips security prompt for bulk operations
  -i, --ssh-public-key string      SSH public key for access via ssh and console. [optional]
                                   Can be either the public key as string, or pointing to the public key file to use e.g.: "@~/.ssh/id_rsa.pub".
                                   If ~/.ssh/[id_ed25519.pub | id_rsa.pub | id_dsa.pub] is present it will be picked as default, matching the first one in this order.
      --timestamps                 when used with --file (bulk operation): prints timestamps in-between the operations
      --userdata string            cloud-init.io compatible userdata. [optional]
                                   Can be either the userdata as string, or pointing to the userdata file to use e.g.: "@/tmp/userdata.cfg".

Options inherited from parent commands

      --api-token string       the token used for api requests
      --api-url string         the url to the metal-stack.io api
  -c, --config string          alternative config file path, (default is ~/.metal-stack/config.yaml)
      --debug                  debug output
      --force-color            force colored output even without tty
  -o, --output-format string   output format (table|wide|markdown|json|yaml|template), wide is a table with more columns. (default "table")
      --template string        output template for template output-format, go template format. For property names inspect the output of -o json or -o yaml for reference.
      --timeout duration       request timeout used for api requests

SEE ALSO

• metalctlv2 machine - manage machine entities