go.chromium.org/luci@v0.0.0-20240309015107-7cdc2e660f33/auth_service/README.md (about)

     1  Auth Service
     2  ------------
     3  
     4  Auth Service will manages and distribute data and configuration used for authorization decisions performed by services in a LUCI cluster.
     5  
     6  This is a replacement the [GAE v1 version of Auth Service](https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/appengine/auth_service).
     7  
     8  
     9  Running locally
    10  ---------------
    11  
    12  Targeting the real datastore:
    13  
    14  ```
    15  cd auth_service/services/frontend
    16  go run main.go -cloud-project chrome-infra-auth-dev
    17  
    18  ```
    19  
    20  The server will be available at http://localhost:8800.
    21  
    22  
    23  Uploading to GAE for adhoc testing
    24  ----------------------------------
    25  
    26  Prefer to test everything locally. If you must deploy to GAE, use:
    27  
    28  ```
    29  cd auth_service
    30  gae.py upload -A chrome-infra-auth-dev --app-dir services defaultv2 backendv2
    31  
    32  ```
    33  
    34  Note that it doesn't switch the default serving version. Use Cloud Console
    35  or `gcloud app services set-traffic` to switch the serving version of
    36  `defaultv2` and `backendv2` services. Be careful not to touch `default` and
    37  `backend`. They are deployed from Python code.
    38  
    39  
    40  Production deployment
    41  ---------------------
    42  
    43  Deployment to staging and production are performed by [gae-deploy] builder.
    44  Deploying directly to production using `gae.py` is strongly ill-advised.
    45  
    46  [gae-deploy]: https://ci.chromium.org/p/infradata-gae/builders/ci/gae-deploy