IronFlock CLI

ironflock은 머신에 있는 IronFlock 소프트웨어를 다루는 명령줄 도구입니다. 이 도구로 Linux 머신을 디바이스로 IronFlock에 연결하고, IronFlockOS를 USB 스틱, SD 카드 또는 디스크에 쓰고, 실행 중인 머신의 Linux를 IronFlockOS로 교체하며, IronFlockOS 디바이스를 업데이트, 롤백, 재설정하고, IronFlock 어플라이언스를 설치하고 관리합니다.

ironflock은 플랫폼마다 하나의 정적 바이너리입니다. 런타임도 다른 패키지도 필요하지 않습니다. Linux 또는 macOS에서 한 줄로 설치합니다:

curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash

스크립트는 /usr/local/bin/ironflock을 설치하기 전에 다운로드한 파일을 IronFlock 릴리스 키로 확인합니다. 나중에 sudo ironflock self-update로 최신 릴리스로 업데이트합니다. 각 단계, 스크립트를 먼저 검증하는 방법, 업데이트 방법은 설치에서 설명합니다.

명령은 제품별로 그룹으로 묶여 있습니다. 디바이스 에이전트는 ironflock agent, IronFlock 어플라이언스는 ironflock appliance, IronFlockOS는 ironflock os입니다. 동사는 모든 그룹에서 같은 뜻입니다. ironflock status처럼 머신 전체에 관한 명령에는 그룹이 없습니다. ironflock --help는 명령 목록을 보여 주고, ironflock <command> --help는 명령 하나를 설명합니다.

작업별 명령

모든 명령은 전역 플래그를 받습니다. 그중에는 명령의 질문에 답하는 --yes와, 프로그램이 읽을 수 있도록 결과를 하나의 JSON 객체로 쓰는 --json이 있습니다.

# 한 줄로 ironflock을 설치하고 이 Linux 머신을 device.flock의 디바이스로 연결
curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c device.flock
 
# 이 머신이 디바이스 에이전트를 실행하고 device.flock의 호스트에 도달할 수 있는지 검사
ironflock doctor -c device.flock
 
# device.flock의 디바이스용 IronFlockOS를 드라이브 /dev/sdb에 쓰기
sudo ironflock os flash -c device.flock -d /dev/sdb
 
# 이 머신의 Linux를 IronFlockOS로 교체하는 계획을 보여 주고, 아무것도 변경하지 않기
sudo ironflock os install -c device.flock --dry-run
 
# 노트북에서 SSH로 디바이스의 상태 표시
ironflock --host pi@device-17 status

지원 시스템

ironflock은 Linux용(amd64, arm64, 32비트 ARM v5~v7)과 macOS용(Apple silicon, Intel)으로 릴리스됩니다.

어떤 시스템에서 실행되지 않는 명령도 그 시스템의 ironflock에 들어 있습니다. 이런 명령은 아무것도 살펴보기 전에 종료 코드 3으로 끝납니다. agent 명령에는 systemd를 사용하는 Debian 또는 Ubuntu 기반 Linux가 필요합니다. os install에는 64비트 UEFI 펌웨어(amd64 또는 arm64)에서 systemd를 사용하는 Linux가 필요합니다. appliance 명령은 어플라이언스 명령에서 설명합니다.

IronFlockOS 디바이스에서는 이미지가 시스템과 함께 디바이스 에이전트를 제공합니다. 따라서 그곳에서 agent install과 agent remove는 종료 코드 3으로 거부되며, 디바이스에 다른 .flock 파일을 적용하려면 agent configure -c를 사용합니다.

--host를 사용하면 completion을 제외한 모든 명령이 SSH로 다른 Linux 머신에서 실행됩니다. Mac에서는 이 방법으로 agent 명령, os install, IronFlockOS 디바이스의 명령을 실행합니다.

0.15.0 이후의 IronFlockOS 릴리스는 디바이스에 ironflock을 /usr/bin/ironflock으로 포함합니다. IronFlockOS 0.15.0 이하에는 없습니다. 이런 디바이스의 명령은 다른 컴퓨터에서 --host로, 디바이스의 SSH 사용자(SSH 접근)로 실행하십시오:

ironflock --host operator@kitchen-pc os update --reboot --yes

참고: 명령의 메시지와 JSON 필드는 IronFlock Studio와 이 문서에서 프로젝트라고 부르는 것을 swarm이라고 하고, 프로젝트 소유자를 “swarm owner”라고 합니다. 예를 들어 ironflock status --json의 필드 agent.swarm은 디바이스의 프로젝트를 나타냅니다.

이 섹션의 내용

• 설치: 설치 명령줄, 스크립트 검증, 다운로드 베이스와 어플라이언스의 미러, Tab 자동 완성, ironflock version과 ironflock self-update.
• 플래그, 출력 및 종료 코드: 모든 명령에 적용되는 전역 플래그, stdout과 JSON, 질문, root, 시크릿, 종료 코드.
• SSH를 통한 원격 머신: 머신 하나에는 --host, 여러 머신에는 --hosts와 --parallel.
• 디바이스 에이전트 명령: 디바이스 에이전트의 설치, 구성, 업데이트, 제거, 재시작, 중지, 시작, 그리고 로그 읽기.
• status 및 doctor: 머신에서 IronFlock의 무엇이 실행 중인지, 그리고 머신이 디바이스 에이전트를 실행할 수 있는지.
• IronFlockOS를 드라이브에 쓰기: 이미지와 드라이브 나열, 디바이스의 .flock 파일과 함께 IronFlockOS 쓰기.
• Linux를 IronFlockOS로 교체: 실행 중인 Linux 머신을 IronFlockOS 디바이스로 전환.
• 업데이트, 롤백 및 재설정: IronFlockOS 디바이스를 최신 상태로 유지하거나, 이전 릴리스로 되돌리거나, 재설정.
• 어플라이언스 명령: 머신에 IronFlock 어플라이언스를 설치, 구성, 업데이트하고 관리.