github.com/tickoalcantara12/micro/v3@v3.0.0-20221007104245-9d75b9bcbab9/docs/v2/framework/run.md (about)

     1  ---
     2  title: Run
     3  keywords: run
     4  tags: [run]
     5  sidebar: home_sidebar
     6  permalink: /run
     7  summary: 
     8  ---
     9  
    10  # micro run
    11  
    12  The **micro run** command manages the lifecycle of a microservice. It fetches the source, builds a binary and executes it. 
    13  It's a simple tool which can be used for local development. If no arguments are specified micro run operates as a service 
    14  which can manage other services.
    15  
    16  Note: The default runtime (Go) requires the Go binary in PATH and GOPATH to be set.
    17  
    18  ## Overview
    19  
    20  Run
    21  
    22  ```
    23  micro run github.com/service/foo
    24  ```
    25  
    26  Status
    27  
    28  ```
    29  micro run -s github.com/service/foo
    30  ```
    31  
    32  Kill
    33  
    34  ```
    35  micro run -k github.com/service/foo
    36  ```
    37  
    38  Run service manager
    39  
    40  ```
    41  micro run
    42  ```
    43  
    44  Defer run to service manager
    45  
    46  ```
    47  micro run -x github.com/service/foo
    48  ```
    49  
    50  Run and restart on death
    51  
    52  ```
    53  micro run -r github.com/service/foo
    54  ```
    55  
    56  Run and update source on fetch
    57  
    58  ```
    59  micro run -u github.com/service/foo
    60  ```
    61  
    62  ## Usage
    63  
    64  ```
    65  NAME:
    66     micro run - Run the micro runtime
    67  
    68  USAGE:
    69     micro run [command options] [arguments...]
    70  
    71  OPTIONS:
    72     -k	Kill service
    73     -r	Restart if dies. Default: false
    74     -u	Update the source. Default: false
    75     -x	Defer run to service. Default: false
    76     -s	Get service status
    77     
    78  ```
    79  
    80  ## TODO
    81  
    82  - [ ] Accept args and env vars to service 
    83  - [ ] Add Service interface to [go-run](https://github.com/micro/go-run)
    84  - [ ] Support configurable runtimes beyond Go
    85  - [ ] Rebuild with plugins
    86  - [ ] Daemonization?
    87  - [ ] Watch memory consumption and kill?
    88  - [ ] Chroot the process?
    89  
    90