ays command line

ays commands:

ays commands:
    init:
    - is the start of everthing, this action makes sure that the ays instance gets created locally & all arguments properly filled in
    - do not forget to specify which other service you consume e.g. $role/$domain|$name!$instance,$role2/$domain2|$name2!$instance2|$role
    install:
    - download all related git repos (if not downloaded yet, otherwise update)
    - prepare & copyfiles & configure
    - start the app
    list:
    - list the ayses
    stop-start-restart
    build
    - if build instructions are given the build repos will be downloaded & build started
    - build happens to production dir
    mdupdate
    - update all git repos which have services metadata
    update
    - go over all related repos & do an update
    - copy the files again
    - restart the app
    reset
    - remove build repos !!!
    - remove state of the app (same as resetstate) in jumpscale (the configuration info)
    - remove data of the app
    resetstate
    - remove state of the app (same as resetstate) in jumpscale (the configuration info)
    removedata
    - remove data of app (e.g. database, e.g. vmachine when node ays)
    execute
    - execute cmd on service e.g. ssh cmd on node ays or sql statement on database ...
    - use --cmd with to specify command to be execute
    monitor
    - do uptime check, local monitor & remote monitor check, if all ok return True
    configure
    - configure the app
    cleanup
    - remote old logfiles, ...
    export/import
    - use --url to specify where to import from or export to
    create
    - interactively create a ays
    status
    - display status of installed ayses (domain, name, priority, version, port)
    nodes
    - display all remote nodes available for ays remote execution
    console
    - connect thourgh ssh to remote node
    hrdpath
    - return the path to the hrd directory

usage: ays [-h] [--noremote] [-q] [-n NAME] [-d DOMAIN] [-i INSTANCE] [-f]
           [--nodeps] [--verbose] [--local] [--data DATA] [--cmd CMD]
           [--parent PARENT] [-r] [-s] [-c CONSUME] [--url URL] [--installed]
           [--tolocal TOLOCAL]
           {init,install,list,stop,start,restart,build,prepare,mdupdate,update,reset,resetstate,removedata,monitor,configure,cleanup,export,import,uninstall,push,execute,status,nodes,console,hrdpath,makelocal}

positional arguments:
  {init,install,list,stop,start,restart,build,prepare,mdupdate,update,reset,resetstate,removedata,monitor,configure,cleanup,export,import,uninstall,push,execute,status,nodes,console,hrdpath,makelocal}
                        Command to perform

optional arguments:
  -h, --help            show this help message and exit
  --noremote            bypass the @remote wrapper

Service Selection:
  -q, --quiet           Put in quiet mode
  -n NAME, --name NAME  Name of ays to be installed
  -d DOMAIN, --domain DOMAIN
                        Name of ays domain to be installed
  -i INSTANCE, --instance INSTANCE
                        Instance of ays (default main)
  -f, --force           auto answer yes on every question
  --nodeps              Dont perfomr action on dependencies, default False
  --verbose             Verbose output.
  --local               Apply action locally. No remote services will be
                        executed.

Install/Update/Expand/Configure:
  --data DATA           use this to pass hrd information to ays e.g.
                        'redis.name:system redis.port:9999 redis.disk:0'
  --cmd CMD             use this to pass cmd to services e.g. 'ls -l'
  --parent PARENT       parent service (domain|name!instance).
  -r, --reinstall       Reinstall found service
  -s, --single          Do not install dependencies
  -c CONSUME, --consume CONSUME
                        specify which services you consume example syntax:
                        e.g. $role/$domain|$name!$instance,$role2/$domain2|$na
                        me2!$instance2|$role

Export/Import:
  --url URL             uncpath to export to or import from

List:
  --installed           List installed ayses

ays command line actions

  • install Configure, install and run a service
  • uninstall Uninstall a service
  • list --installed List all installed services
  • stop Stop a running service
  • start Start a service
  • restart Restart a service
  • update Update and restart a service installation
  • resetstate Clear service state (only)
  • reset Does resetstate + clean build data + clean service data
  • cleanup Remove Old log files, and do Housekeeping.
  • monitor Monitor the state of a local/remote service
  • import/export --url=... Import/Export service data from/to pre-configured location
  • build Build a service, start from the last unsuccessful build stage
  • configure Reconfigure a service installation runtime parameters
  • mdupdate Like Ubuntu's apt-get update, it update metadata for services
  • status display status of installed ayss (domain, name, priority, version, port)
  • --data pass Config data on the fly
  • --cmd 'command' pass command to execute action of ays
  • --verbose Activate verbose mode
  • -n serviceName Use -n to pass the service name
  • -n serviceName -d domainName Use -d to pass domain name.
  • -n serviceName -i instanceName Use -i to pass instance name
  • -n serviceName --nodeps By default if you do an action to service like start/stop this action will be propagated to all service dependencies which is handy thing, but sometimes for certain actions you do want this only to be applied on the service itself like resetstate, use --nodeps in those cases.
  • -- local to apply action only to locally installed services
  • --parent domainName__serviceName__instanceName to specify parent for service. For further ancestry, can be used --parent ancestorDomain__ancestorName__ancestorInstance:parentDomain__parentName__parentInstance
  • --console to access the console of a remote service
  • --targetname serviceInstance --targettype serviceName to specify action on remote node
  • consume --category categoryName producerInstanceName to consume specified producer category and instance for this service
  • --hrdseed prefilledHRD.hrd to give the path to an hrd file that contains the instance arguments of a services.
  • --immediate to indicate provided parent path is the exact one to use. If neither path nor parent is path, action will be performed on the root of the configured directory.

AYS cmd line examples:

#updates the metadata
ays mdupdate

#select osis, install osis and its dependencies
ays init -n osis -c "mongodb|mongodb!main"
#many consumptions are done automatically e.g. the mongodb one if you don't specify 
#ays will look for a preconfigured instance mongodb and if only 1 found will use that one

#next will not look at dependencies
ays init -n osis --nodeps

#Install with hrd configuration
ays init -n redis -i system --data 'param.name:system param.port:7766 param.disk:0  param.mem:100 param.ip:127.0.0.1 param.unixsocket:0 param.passwd:'
#whatever you pass with --data is used to populate the hrd of the instance

#this is the main command which will ask ays go over all init'ed ays recipe's and try to install them if anything changed
#so already installed/configured ays will not be touched unless if some configuration change was made
ays apply

# Show current status of installed AYSes
ays status

# Show current status of locally installed AYSes
ays status --local

results matching ""

    No results matching ""