info_tfgrid/collections/developers/tfcmd/tfcmd_basics.md
2024-05-14 11:30:30 -04:00

2.2 KiB

TFCMD Getting Started

Table of Contents


Introduction

This section covers the basics on how to set up and use TFCMD (tfcmd).

TFCMD is available as binaries. Make sure to download the latest release and to stay up to date with new releases.

Installation

An easy way to use TFCMD is to download and extract the TFCMD binaries to your path.

  • Download latest release from releases
    wget <binaries_url>
    
  • Extract the binaries
    tar -xvf <binaries_file>
    
  • Move tfcmd to any $PATH directory:
    mv tfcmd /usr/local/bin
    

Login

Before interacting with Threefold Grid with tfcmd you should login with your mnemonics and specify the grid network:

$ tfcmd login
Please enter your mnemonics: <mnemonics>
Please enter grid network (main,test): <grid-network>

This validates your mnemonics and store your mnemonics and network to your default configuration dir. Check UserConfigDir() for your default configuration directory.

Commands

You can run the command tfcmd help at any time to access the help section. This will also display the available commands.

Command Description
cancel Cancel resources on Threefold grid
completion Generate the autocompletion script for the specified shell
deploy Deploy resources to Threefold grid
get Get a deployed resource from Threefold grid
help Help about any command
login Login with mnemonics to a grid network
version Get latest build tag

Using TFCMD

Once you've logged in, you can use commands to deploy workloads on the TFGrid. Read the next sections for more information on different types of workloads available with TFCMD.