blob: 08ebfe3768a4ffbe2a41cff4115b9ae1dc2a8101 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
# gVisor Website
This repository holds the content for the gVisor website. It uses
[hugo](https://gohugo.io/) to generate the website and
[Docsy](https://github.com/google/docsy) as the theme.
## Requirements
Building the website requires the extended version of
[hugo](https://gohugo.io/) and [node.js](https://nodejs.org/) in order to
generate CSS files. Please install them before building.
- Node.js >= 10.15.0 LTS
- hugo extended >= v0.53
## Building
Build the website using `make`:
```
make
```
This will output the App Engine application code, configuration, and html and
CSS into the `public/` directory.
## Testing
You can use the hugo web server for testing. This will start a webserver that
will rebuild the site when you make content changes:
```
make server
```
Access the site at http://localhost:8080
## Deploy
Deploying the website to App Engine requires gcloud. First create a configuration:
```
{
gcloud config configurations create gvisor-website
gcloud config set project gvisor-website
}
```
Deploy the application:
```
make deploy
```
## Editing documentation
Documentation is located in the [content/docs/](content/docs/) directory.
Documentation is written in markdown with hugo extensions. Please read more
about [content management](https://gohugo.io/categories/content-management) in
the hugo documentation.
## Submit a Build
Normally a build is triggered when you push to the gvisor-website repository.
However, you can submit a build to Cloud Build manually.
As one-time setup, enable the App Engine Admin API, and set IAM roles for the [Cloud Build service
account](https://cloud.google.com/cloud-build/docs/securing-builds/set-service-account-permissions).
```
{
PROJECT_NUMBER=$(gcloud projects list --filter=gvisor-website --format="value(projectNumber)")
gcloud services enable appengine.googleapis.com
gcloud projects add-iam-policy-binding gvisor-website \
--member=serviceAccount:${PROJECT_NUMBER}@cloudbuild.gserviceaccount.com \
--role='roles/appengine.deployer'
gcloud projects add-iam-policy-binding gvisor-website \
--member=serviceAccount:${PROJECT_NUMBER}@cloudbuild.gserviceaccount.com \
--role='roles/appengine.serviceAdmin'
}
```
Submit the build.
```
make cloud-build
```
|
