sr.ht-docs/tutorials/builds.sr.ht/index.html

99 lines
3.3 KiB
HTML

---
title: builds.sr.ht tutorials
---
<p>
Ready to do more with builds.sr.ht? Here is a collection of useful tutorials
for setting up various kinds of build automations.
</p>
<style>
.tutorial:not(:last-child) {
margin-bottom: 1rem;
}
</style>
<div class="event-list">
<div class="event" style="margin-left: -0.5rem; margin-right: -0.5rem;">
<h3 id="getting-started-with-buildssrht">Getting started with builds.sr.ht</h3>
<p>
Running your first few jobs on our continuous integration platform,
builds.sr.ht.
</p>
<a href="../getting-started-with-builds.md" class="btn btn-success">
Read more
<span class="icon icon-caret-right">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
</span>
</a>
</div>
</div>
<div class="tutorial">
<h3>Using builds.sr.ht for GitHub CI</h3>
<p>
builds.sr.ht can be used to run CI for platforms outside of sourcehut -
here's how.
</p>
<a href="github-integration.md" class="btn btn-default">
Read more
<span class="icon icon-caret-right">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
</span>
</a>
</div>
<div class="tutorial">
<h3>Handling secrets in your build manifests</h3>
<p>
You can add secrets like SSH keys to your builds to automate deployments
and more.
</p>
<a href="using-build-secrets.md" class="btn btn-default">
Read more
<span class="icon icon-caret-right">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
</span>
</a>
</div>
<hr />
<div class="alert alert-primary">
<strong>More tutorials are coming!</strong>
Is there something in particular you want to see here? Mention it on
<a href="https://lists.sr.ht/~sircmpwn/sr.ht-discuss">sr.ht-discuss</a>!
</div>
<h3 id="example-manifests">Example build manifests</h3>
<p>
Here are a few example build manifests to quickly get you started. Got one of
your own to add? Send a patch to
<a href="https://lists.sr.ht/~sircmpwn/sr.ht-dev">sr.ht-dev</a> editing this
page!
</p>
<ul>
<li>
<a href="https://git.sr.ht/~sircmpwn/pages.sr.ht-examples/tree">
Example manifests
</a>
for
<a href="https://srht.site">
pages.sr.ht
</a>
</li>
<li>
<a href="https://git.sr.ht/~sircmpwn/git.sr.ht/tree/master/.builds/alpine.yml">
Building Alpine Linux packages for a third-party repo
</a>
</li>
<li>
<a href="https://git.sr.ht/~sircmpwn/git.sr.ht/tree/master/.builds/archlinux.yml">
Building Arch Linux packages for a third-party repo
</a>
</li>
<li>
<a href="https://git.sr.ht/~emersion/mrsh/tree/master/.builds">
Testing a C project on 3 platforms
</a>
</li>
<li>
<a href="https://git.sr.ht/~xaffe/matrix-dokumentation/tree/master/.build.yml">
Use a specific node version in your build with nvm
</a>
</li>
</ul>