Commit Graph

19 Commits (4b001c524c3785b97a1ef80057e9b0cb081eb62c)

Author SHA1 Message Date
Andrew Morgan a17023962c Update CircleCI and Buildkite configs to build the new spec (#3017)
This PR attempts to update the CI of matrix-doc to build [the new spec redesign](https://github.com/matrix-org/matrix-doc/issues/2906). It does so by additionally building the new spec in parallel to the old. The plan is to continue to host the old spec at https://matrix.org/docs/spec, while the new spec will be at https://spec.matrix.org. Eventually we will retire the old version of the spec, and have the old URL redirect to the new one.

In detail, this PR:
* Adds a new step to CircleCI to build the new spec with `hugo`. This step uses alpine, grabs some dependencies, and then builds the HTML.
  * We needed to hand some specific options to hugo for CircleCI in order to continue allowing CircleCI to host temporary builds of the spec after each CI run. This required changing some assumptions related to relative paths.
  * CircleCI's artifacts hosting is also quite limited. Specifically it will not automatically resolve `/some/path` to `/some/path/index.html`, which our hugo theme relied on. Fixes were implemented for this, but we may want to consider switching away from CircleCI artifacts as a host, and using something like [netlify](https://www.netlify.com/) instead.
* Modifies the existing Buildkite pipeline step to build both the new spec in a separate step. It additionally modifies the old spec to be built with alpine. (Separate out into another PR)
  * We'd like to separate out the deployment of matrix.org from the new spec. Therefore a new step, with a separate artifact build (`spec.tar.gz`). We will eventually remove the old step and the matrix.org build trigger.
* Modifies `pyproject.toml` to update the config of [giles](https://github.com/OpenAstronomy/baldrick/blob/master/baldrick/plugins/circleci_artifacts.py), which is what creates the "docs", "swagger" links in the CI steps for matrix-docs PRs.
  * A new step was added for the new spec. The old spec was renamed to "legacy".
3 years ago
Andrew Morgan 25605b65a3 Don't generate matrix assets on CircleCI (#3034)
We already do this in the buildkite pipeline, so doing so in CircleCI is just
duplicate work.
3 years ago
Andrew Morgan 3c66e149f3 Move validator.js to scripts/ directory, update calls 3 years ago
Andrew Morgan b8dafe86f4 Move and more aptly name check_examples.py scripts 3 years ago
Stuart Mumford 9574f3c8d0
update to the new deployment of Giles
Signed-off-by: Stuart Mumford <stuart@cadair.com>
5 years ago
Travis Ralston 5acac5a44e Try bumping golang version 5 years ago
Travis Ralston 132c5b0f48 Verbose building for go scripts 6 years ago
Travis Ralston e97a1b4af0 Actually add the dev scripts build to the workflow 6 years ago
Travis Ralston 349696fc1d Test building of the speculator and continuserv 6 years ago
Travis Ralston 791a2f2b17 Run the validator on the spec 6 years ago
Travis Ralston 17ae84d064 Check the API examples too 6 years ago
Travis Ralston 80edda1666 Actually run the check-docs circle job 6 years ago
Travis Ralston 0a6c1c4dda Ensure the event examples and matrix.org assets are tested
Otherwise we go nearly a week without realizing the build is failing due to bad schemas/examples. This also helps us ensure a PR is up to par.

This commit is expected to cause a build failure at this time. A future commit will actually fix the project and address concerns raised by the testing.
6 years ago
Stuart Mumford 59bdcb5615
Clone and configure the swagger UI as a circle CI artifact
Signed-off-by: Stuart Mumford <stuart@cadair.com>
6 years ago
Stuart Mumford be5232914a
Maybe a swagger 6 years ago
Stuart Mumford b7c3a74022
artifacts 6 years ago
Stuart Mumford fe43b79e73
what's even the point 6 years ago
Stuart Mumford 86b0045195
virtualenvs are the worst 6 years ago
Stuart Mumford d1c8ec9e48
add circle config 6 years ago