- How to use the project
- Used Technologies & Prerequisites
- Start for Development
- Setup for Production
- Get and install the binary
- Add as a Systemd service
The TFGrid client Proxy acts as an interface to access information about the grid. It supports features such as filtering, limitation, and pagination to query the various entities on the grid like nodes, contracts and farms. Additionally the proxy can contact the required twin ID to retrieve stats about the relevant objects and performing ZOS calls.
The proxy is used as the backend of several threefold projects like:
If you don't want to care about setting up your instance you can use one of the live instances. each works against a different TFChain network.
- Dev network: https://gridproxy.dev.grid.tf
- Qa network: https://gridproxy.qa.grid.tf
- Test network: https://gridproxy.test.grid.tf
- Main network: https://gridproxy.grid.tf
Or follow the development guide to run yours. By default, the instance runs against devnet. to configure that you will need to config this while running the server.
Note: You may face some differences between each instance and the others. that is normal because each network is in a different stage of development and works correctly with others parts of the Grid on the same network.
- GoLang: Mainly the two parts of the project written in
Go 1.17, otherwise you can just download the compiled binaries from github releases
- Postgresql: Used to load the TFGrid DB
- Docker: Containerize the running services such as Postgres and Redis.
- Mnemonics: Secret seeds for adummy identity to use for the relay client.
For more about the prerequisites and how to set up and configure them. follow the Setup guide
To start the services for development or testing make sure first you have all the Prerequisites.
Clone this repo
git clone https://github.com/threefoldtech/tfgrid-sdk-go.git cd tfgrid-sdk-go/grid-proxy
Makefilehas all that you need to deal with Db, Explorer, Tests, and Docs.
make help # list all the available subcommands.
For a quick test explorer server.
make all-start e=<MNEMONICS>
Now you can access the server at
Run the tests
To run in development environment see here how to generate test db or load a db dump then use:
go run cmds/proxy_server/main.go --address :8080 --log-level debug -no-cert --postgres-host 127.0.0.1 --postgres-db tfgrid-graphql --postgres-password postgres --postgres-user postgres --mnemonics <insert user mnemonics>
For more illustrations about the commands needed to work on the project, see the section Commands. For more info about the project structure and contributions guidelines check the section Contributions.
You can either build the project:
make build chmod +x cmd/proxy_server/server \ && mv cmd/proxy_server/server /usr/local/bin/gridproxy-server
Or download a release: Check the releases page and edit the next command with the chosen version.
wget https://github.com/threefoldtech/tfgrid-sdk-go/releases/download/v1.6.7-rc2/tfgridclient_proxy_1.6.7-rc2_linux_amd64.tar.gz \ && tar -xzf tfgridclient_proxy_1.6.7-rc2_linux_amd64.tar.gz \ && chmod +x server \ && mv server /usr/local/bin/gridproxy-server
Create the service file
cat << EOF > /etc/systemd/system/gridproxy-server.service [Unit] Description=grid proxy server After=network.target [Service] ExecStart=gridproxy-server --domain gridproxy.dev.grid.tf --email email@example.com -ca https://acme-v02.api.letsencrypt.org/directory --substrate wss://tfchain.dev.grid.tf/ws --postgres-host 127.0.0.1 --postgres-db db --postgres-password password --postgres-user postgres --mnemonics <insert user mnemonics> Type=simple Restart=always User=root Group=root [Install] WantedBy=multi-user.target Alias=gridproxy.service EOF