/fandogh-cli

Fandogh CLI

Primary LanguagePythonMIT LicenseMIT

PyPI version Downloads Build Status

Fandogh-CLI

fandogh-cli is the official CLI of Fandogh PaaS. One with the current version of the CLI can create new images on Fandogh and publish the versions and deploy them as service.

How to install the CLI

Please note that Fandogh-cli is a python based application which needs the python 3.5 or higher. Run the following command to install the CLI:

pip install fandogh-cli

Once it's installed run the following command to see the installation has been done successfully.

fandogh --version

If the output of the above command is the version of the Fandogh CLI... then congratulations you can now enjoy the taste of the Fandogh. Otherwise please create an issue here with the output of the command to help us fixing the issues ASAP.

How to login

After you install the CLI, run the following command to log in with your Fandogh account credentials:

fandogh login

When you run fandogh login it wil prompt for username and password which will be used to obtain a token. The token will be stored in $HOME/.fandogh/credentials and later will be used by all other fandogh commands.

How to create a new Image

In order to create a new image in Fandogh you need to change your current directory to the directory of your application, then you can run the following command:

$ cd ~/your-app-directory
$ fandogh image init
$ image name: test-application
Image created successfully

Now it's time to publish the first version of your image. An image in fandogh consists of a Dockerfile and the files which are necessary (a.k.a context) to build the docker image. For the time being your Dockerfile should be in the root of your application directory. Run the following command to publish your image version:

$ fandogh image publish 
$ image version: v1
Image Version created successfully

How to deploy a service

Deploying a service on Fandogh is easy as pie. Let's say you have an image with name hello-world which has a version named v1 in state BUILT.

Run the following command to deploy your service:

$ fandogh service deploy  --image hello-world --version v1 --name hello-world
Your service deployed successfully.
The service is accessible via following link:
http://hello-world.fandogh.cloud

The above command will deploy a service with name hello-world from docker image hello-world:v1. You can also use the following options when running deploy command:

  • --port or -p: to specify which port of of container should be exposed
  • --internal: to indicate that this service is an internal service and the port should only be accessible within the private network
  • --env or -e: to specify environment variables to set in the container.you can use this option as many as you need, for example fandogh service deploy --image hello-world --version v1 --name hello-world --env some_variable=some_value --env another_variable=another_value

How to shutdown a service

Releasing the resources is your friend to manage your cost. In cloud you can easily free the resource and not to pay for it anymore. To do so via fandogh-cli it's even simpler than deploying a service. Let's say we want to destroy the service we deployed in the previous section.

$ fandogh service destroy  --name hello
Service destroyed successfully.

Managed Services

Fandogh Platform provides a set of production ready managed services that you can deploy in seconds and use them via your services. The following list consist of the managed services we already support.

MySQL Service

The MySQL Managed Service on Fandogh consist of Mysql RDBMS itself and Web UI (PHPMyAdmin) that let you to manage your DBMS. In order to log into the Web UI you can use the root user credentials.

Username: root

password: root (can be changed through config options)

You can deploy a MySQL Server in your namespace by running the following command:

$ fandogh managed-service deploy mysql 9.4

Your Mysql service will be ready in a few seconds.
You can have access to the PHPMyAdmin via following link:
http://mysql.your_namespace.fandogh.cloud

From your services you can access to the Mysql by using mysql:3306 address.

Configuration

There are a couple of configuration that you can pass to Fandogh when you are deploying a Mysql service:

  • service_name default: mysql

    The value of this field will be the name of your DBMS. as the result this name will change the URL of your phpmyadmin panel. e.g. If you set service_name=test-dbms then the admin URL will be something like http://test-dbms.your_namespace.fandogh.cloud

  • phpmyadmin_enabled default: true

    This is a boolean field that indicates if you want to have phpmyadmin running for this RDBMS or not. e.g. If you set phpmyadmin_enabled=false then the admin UI won't be deployed for the given DBMS.

  • mysql_root_password default: root

    The value of this field will be the password of your mysql root password.

Example:

$ fandogh managed-service deploy mysql 9.4 \
      -c service_name=test-dbms \
      -c phpmyadmin_enabled=false \
      -c mysql_root_password=test123

Postgresql Service

The Postgresql Managed Service on Fandogh consist of Postgresql RDBMS itself and Web UI (Adminer) that let you to manage your DBMS as easy as possible. In order to log into the Adminer UI you can use the postgres user credentials.

Username: postgres

password: postgres (can be changed through config options)

You can deploy a Postgresql Server in your namespace by running the following command:

$ fandogh managed-service deploy postgresql 10.4

Your Postgresql service will be ready in a few seconds.
You can have access to the Adminer via following link:
http://postgresql.your_namespace.fandogh.cloud

From your services you can access to the service by using postgresql:5432 address.

Configuration

There are a couple of configuration that you can pass to Fandogh when you are deploying a Postgresql service:

  • service_name default: postgresql

    The value of this field will be the name of your DBMS. as the result this name will change the URL of your phpmyadmin panel. e.g. If you set service_name=test-dbms then the admin URL will be something like http://test-dbms.your_namespace.fandogh.cloud

  • adminer_enabled default: true

    This is a boolean field that indicates if you want to have adminer running for this RDBMS or not. e.g. If you set adminer_enabled=false then the adminer panel won't be deployed for the given DBMS.

  • postgres_password default: postgres

    The value of this field will be the password of user postgres.

Example:

$ fandogh managed-service deploy postgresql 10.4 \
       -c service_name=test-dbms \ 
       -c adminer_enabled=false \
       -c postgres_password=test123

Custom domain

Normally your external services is accessible via service-name-namespace.fandogh.cloud on HTTP and HTTPS, but you might like to use your custom domain name, like somedomain.com. In order to do this you need to submit and verify your domain in fandogh, it's easy :

  1. first run fandogh domain add --name=somedomain.com
  2. if you're adding a subdomain of a verified domain you don't need verification, for example if you already verified tehran.myservice.com then api.tehran.myservice.com doesn't need verification, you just need to add it.
  3. if your domain needs verification, it will stop and show you a key, you need to create a TXT record in your domain with the key value.
  4. after you added the record, press y and enter so fandogh server verify your TXT record.
  5. Now we route all traffic with somedomain.com in Host header to your service, you just need to add a CNAME record pointing your domain to actual service address, for example service-name-namespace.fandogh.cloud if everything goes well, you should be able to use your domain to access your service.

Tip: If you verify a domain, all subdomains of that domain will not require verification, but you should add them before using them
Remember, if you use a domain like api.somedomain.com, then you should set TXT record on api.somedomain.com not somedomain.com.

Table of exit status codes

Status code Reason
101 Command parameter exception
102 Fandogh API exception
103 Authentication error
104 Request exception
201 State of the image is FAILED
301 Invalid image name
302 Couldn't get service details
303 Service details has unknown state