# Scripts

## get-fedora-coreos

Run the `get-fedora-coreos` script to download Fedora CoreOS images, verify them, and move them into `examples/assets`.

```
./scripts/get-fedora-coreos
./scripts/get-fedora-coreos stream version dest
```

This will create:

```
examples/assets/fedora-coreos/
├── fedora-coreos-32.20200923.3.0-live-initramfs.x86_64.img
├── fedora-coreos-32.20200923.3.0-live-kernel-x86_64
├── fedora-coreos-32.20200923.3.0-live-rootfs.x86_64.img
├── fedora-coreos-32.20200923.3.0-metal.x86_64.raw.xz
└── fedora-coreos-32.20200923.3.0-metal.x86_64.raw.xz.sig
```

## get-flatcar

Run the `get-flatcar` script to download Flatcar Linux images, verify them, and move them into `examples/assets`.

```
./scripts/get-flatcar
./scripts/get-flatcar channel version dest
```

This will create:

```
examples/assets/flatcar/
└── 2605.6.0
    ├── Flatcar_Image_Signing_Key.asc
    ├── flatcar_production_image.bin.bz2
    ├── flatcar_production_image.bin.bz2.sig
    ├── flatcar_production_pxe_image.cpio.gz
    ├── flatcar_production_pxe_image.cpio.gz.sig
    ├── flatcar_production_pxe.vmlinuz
    ├── flatcar_production_pxe.vmlinuz.sig
    └── version.txt
```

## libvirt

Create QEMU/KVM VMs which are configured to boot from the network. The `scripts/libvirt` script will create virtual machines on the `metal0` or `docker0` bridge with known hardware attributes (e.g. UUID, MAC address).

    $ sudo ./scripts/libvirt
    USAGE: libvirt <command>
    Commands:
        create      create QEMU/KVM nodes on the docker0 bridge
        start       start the QEMU/KVM nodes
        reboot      reboot the QEMU/KVM nodes
        shutdown    shutdown the QEMU/KVM nodes
        poweroff    poweroff the QEMU/KVM nodes
        destroy     destroy the QEMU/KVM nodes

## k8s-certgen

Generate TLS certificates needed for a multi-node Kubernetes cluster. See the [examples](../examples/README.md#assets).

    $ ./scripts/tls/k8s-certgen -h
    Usage: k8s-certgen
    Options:
      -d DEST     Destination for generated files (default: .examples/assets/tls)
      -s SERVER   Reachable Server IP for kubeconfig (e.g. node1.example.com)
      -m MASTERS  Controller Node Names/Addresses in SAN format (e.g. IP.1=10.3.0.1,DNS.1=node1.example.com)
      -w WORKERS  Worker Node Names/Addresses in SAN format (e.g. DNS.1=node2.example.com,DNS.2=node3.example.com)
      -h          Show help