mvisonneau/go-ebsnvme

go-ebsnvme is a golang version of the AWS ebsnvme-id python script

TL:DR

~$ go-ebsnvme /dev/nvme0n1
vol-99cff4881d00c56a8
/dev/sda1

~$ go-ebsnvme --volume-id /dev/nvme1n1
vol-80dfffbbee880a72c

~$ go-ebsnvme --device-name /dev/nvme1n1
/dev/xvdf

Install

Have a look onto the latest release page and pick your flavor.

Go

~$ go run github.com/mvisonneau/go-ebsnvme/cmd/go-ebsnvme@latest

Docker

~$ docker run -it --rm mvisonneau/go-ebsnvme

Binaries, DEB and RPM packages

For the following ones, you need to know which version you want to install, to fetch the latest available :

~$ export VERSION=$(curl -s "https://api.github.com/repos/mvisonneau/go-ebsnvme/releases/latest" | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')

# Binary (eg: linux/amd64)
~$ wget https://github.com/mvisonneau/go-ebsnvme/releases/download/${VERSION}/go-ebsnvme_${VERSION}_linux_amd64.tar.gz
~$ tar zxvf go-ebsnvme_${VERSION}_linux_amd64.tar.gz -C /usr/local/bin

# DEB package (eg: linux/386)
~$ wget https://github.com/mvisonneau/go-ebsnvme/releases/download/${VERSION}/go-ebsnvme_${VERSION}_linux_386.deb
~$ dpkg -i go-ebsnvme_${VERSION}_linux_386.deb

# RPM package (eg: linux/arm64)
~$ wget https://github.com/mvisonneau/go-ebsnvme/releases/download/${VERSION}/go-ebsnvme_${VERSION}_linux_arm64.rpm
~$ rpm -ivh go-ebsnvme_${VERSION}_linux_arm64.rpm

Usage

Library

package main

import (
   "fmt"
   "os"

   "github.com/mvisonneau/go-ebsnvme/pkg/ebsnvme"
)

func main() {
   device, err := ebsnvme.ScanDevice("/dev/nvme0n1")
   if err != nil {
      fmt.Println(err)
      os.Exit(1)
   }
   fmt.Println(device)
}

Client

~$ go-ebsnvme -h
NAME:
   go-ebsnvme - Fetch information about AWS EBS NVMe volumes

USAGE:
   go-ebsnvme <block_device> [--volume-id|--device-name]

VERSION:
   <devel>

COMMANDS:
     help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --volume-id, -i    only print the EBS volume-id
   --device-name, -n  only print the name of the block device
   --help, -h         show help
   --version, -v      print the version

Contribute

Contributions are more than welcome! Feel free to submit a PR.