file-to-machineconfig

README

file-to-machineconfig

Simple tool to convert files to MachineConfig objects to be used with the machine-config-operator in Kubernetes/OpenShift.

NOTE: It only supports Ignition configuration specification 2.2 so far.

Features

• Linux/OSX/Windows support (and binaries available in releases/)
• remote path = local path if not provided
• remote owner/group = local if not provided
• sane defaults (...)
• normalized parameters (...)
• multiple labels support
• base64 file encoded content support
• json output
• yaml output

To Do

• Improve normalization and defaults
• Multiple ignition version
• Good code
• Better error handling

Not working

• plain file content support

Usage

If using Fedora/CentOS, you can use this copr, otherwise download the latest binary release:

wget -L https://github.com/e-minguez/file-to-machineconfig/releases/download/0.0.3/file-to-machineconfig-linux-amd64 && \
  mv file-to-machineconfig-linux-amd64 ./file-to-machineconfig && \
  chmod a+x ./file-to-machineconfig

Or, get the code with:

go get -u -v github.com/e-minguez/file-to-machineconfig

NOTE: This requires golang to be installed and GOPATH properly configured.

Then:

file-to-machineconfig --file /local/path/to/my/file.txt > ./my-machine-config.json

Use file-to-machineconfig --help for a more complete usage and flags.

WARNING: Review the generated output first, do not pipe the output directly to kubectl or oc!!!

Example

echo "vm.swappiness=10" > ./myswap.conf

file-to-machineconfig --file ./myswap.conf --remote /etc/sysctl.d/swappiness.conf -yaml > myswap.yaml
...[output]...
2019/11/04 14:55:40 name not provided, using '99-worker-etc-sysctl-d-swappiness-conf' as name
2019/11/04 14:55:40 labels not provided, using 'machineconfiguration.openshift.io/role: worker' by default
2019/11/04 14:55:40 filesystem not provided, using 'root' by default
2019/11/04 14:55:40 apiver not provided, using 'machineconfiguration.openshift.io/v1' by default
2019/11/04 14:55:40 user not provided, using 'edu' as the original file
2019/11/04 14:55:40 group not provided, using 'edu' as the original file
2019/11/04 14:55:40 mode not provided, using '0664' as the original file

cat ./myswap.yaml
apiVersion: machineconfiguration.openshift.io/v1
kind: MachineConfig
metadata:
  creationTimestamp: null
  labels:
    machineconfiguration.openshift.io/role: worker
  name: 99-worker-etc-sysctl-d-swappiness-conf
spec:
  config:
    ignition:
      config: {}
      security:
        tls: {}
      timeouts: {}
      version: 2.2.0
    networkd: {}
    passwd: {}
    storage:
      files:
      - contents:
          source: data:text/plain;charset=utf-8;base64,dm0uc3dhcHBpbmVzcz0xMAo=
          verification: {}
        filesystem: root
        group:
          name: edu
        mode: 436
        path: /etc/sysctl.d/swappiness.conf
        user:
          name: edu
    systemd: {}
  osImageURL: ""

Just to verify:

echo "dm0uc3dhcHBpbmVzcz0xMAo=" | base64 -d
vm.swappiness=10