mirror of
https://github.com/NixOS/nix.dev.git
synced 2024-10-18 00:06:26 -04:00
restructure NixOS tutorials TOC (#1037)
Co-authored-by: Valentin Gagarin <valentin@gagarin.work>
This commit is contained in:
parent
53dff2387f
commit
92f6419bca
|
@ -36,3 +36,4 @@
|
||||||
/manual/nix /reference/nix-manual 200
|
/manual/nix /reference/nix-manual 200
|
||||||
/manual/nix/unstable/* https://hydra.nixos.org/job/nix/master/build.nix.x86_64-linux/latest/download/1/manual/:splat 200
|
/manual/nix/unstable/* https://hydra.nixos.org/job/nix/master/build.nix.x86_64-linux/latest/download/1/manual/:splat 200
|
||||||
/manual/nix/development/* https://hydra.nixos.org/job/nix/master/build.nix.x86_64-linux/latest/download/1/manual/:splat 200
|
/manual/nix/development/* https://hydra.nixos.org/job/nix/master/build.nix.x86_64-linux/latest/download/1/manual/:splat 200
|
||||||
|
/tutorials/nixos/continuous-integration-github-actions /guides/recipes/continuous-integration-github-actions 301
|
||||||
|
|
|
@ -9,7 +9,7 @@ myst:
|
||||||
|
|
||||||
# Continuous integration with GitHub Actions
|
# Continuous integration with GitHub Actions
|
||||||
|
|
||||||
In this tutorial, we'll show you **a few short steps** to get started using [GitHub Actions](https://github.com/features/actions) as your continuous integration (CI) workflow for commits and pull requests.
|
In this guide, we'll show you **a few short steps** to get started using [GitHub Actions](https://github.com/features/actions) as your continuous integration (CI) workflow for commits and pull requests.
|
||||||
|
|
||||||
One benefit of Nix is that **CI can build and cache developer environments for every project** on every branch using binary caches.
|
One benefit of Nix is that **CI can build and cache developer environments for every project** on every branch using binary caches.
|
||||||
|
|
||||||
|
@ -109,4 +109,3 @@ jobs:
|
||||||
|
|
||||||
[magic-nix-cache]: https://github.com/DeterminateSystems/magic-nix-cache-action/
|
[magic-nix-cache]: https://github.com/DeterminateSystems/magic-nix-cache-action/
|
||||||
[github-actions-caching-limits]: https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows
|
[github-actions-caching-limits]: https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows
|
||||||
|
|
|
@ -10,4 +10,5 @@ sharing-dependencies.md
|
||||||
Managing remote sources <./dependency-management.md>
|
Managing remote sources <./dependency-management.md>
|
||||||
Python development environment <./python-environment.md>
|
Python development environment <./python-environment.md>
|
||||||
post-build-hook.md
|
post-build-hook.md
|
||||||
|
continuous-integration-github-actions.md
|
||||||
```
|
```
|
||||||
|
|
|
@ -57,7 +57,7 @@ The following list illustrates some of what can be achieved with the Nix ecosyst
|
||||||
- {ref}`Reproducible development environments <ad-hoc-envs>`.
|
- {ref}`Reproducible development environments <ad-hoc-envs>`.
|
||||||
- Easy installation of software over URLs.
|
- Easy installation of software over URLs.
|
||||||
- Easy transfer of software environments between computers.
|
- Easy transfer of software environments between computers.
|
||||||
- {ref}`Declarative specification of Linux machines <deploying-nixos-using-terraform>`.
|
- {ref}`Declarative specification of Linux machines <deploy-nixos-using-terraform>`.
|
||||||
- {ref}`Reproducible integration testing using virtual machines <integration-testing-vms>`.
|
- {ref}`Reproducible integration testing using virtual machines <integration-testing-vms>`.
|
||||||
- Avoidance of version conflicts with already installed software.
|
- Avoidance of version conflicts with already installed software.
|
||||||
- Installing software from source code.
|
- Installing software from source code.
|
||||||
|
|
|
@ -12,7 +12,7 @@ nix-language.md
|
||||||
Packaging existing software <packaging-existing-software.md>
|
Packaging existing software <packaging-existing-software.md>
|
||||||
Package parameters and overrides <callpackage.md>
|
Package parameters and overrides <callpackage.md>
|
||||||
working-with-local-files.md
|
working-with-local-files.md
|
||||||
nixos/index.md
|
|
||||||
cross-compilation.md
|
cross-compilation.md
|
||||||
module-system/index.md
|
module-system/index.md
|
||||||
|
nixos/index.md
|
||||||
```
|
```
|
||||||
|
|
|
@ -5,8 +5,7 @@ myst:
|
||||||
"keywords": "NixOS, deployment, Terraform, AWS"
|
"keywords": "NixOS, deployment, Terraform, AWS"
|
||||||
---
|
---
|
||||||
|
|
||||||
(deploying-nixos-using-terraform)=
|
(deploy-nixos-using-terraform)=
|
||||||
|
|
||||||
# Deploying NixOS using Terraform
|
# Deploying NixOS using Terraform
|
||||||
|
|
||||||
Assuming you're [familiar with the basics of Terraform](https://www.terraform.io/intro/index.html), by the end of this tutorial you will have provisioned an Amazon Web Services (AWS) instance with Terraform, and will be able to use Nix to deploy incremental changes to NixOS running on the instance.
|
Assuming you're [familiar with the basics of Terraform](https://www.terraform.io/intro/index.html), by the end of this tutorial you will have provisioned an Amazon Web Services (AWS) instance with Terraform, and will be able to use Nix to deploy incremental changes to NixOS running on the instance.
|
||||||
|
|
|
@ -1,14 +1,30 @@
|
||||||
# NixOS
|
# NixOS
|
||||||
|
|
||||||
Learn how to configure, install, and deploy NixOS.
|
Learn how to configure, test, and install or deploy NixOS.
|
||||||
|
|
||||||
|
## Creating NixOS images
|
||||||
|
|
||||||
|
- [](nixos-configuration-on-vm)
|
||||||
|
- [](building-bootable-iso-image)
|
||||||
|
- [](building-and-running-docker-images)
|
||||||
|
|
||||||
|
## Integration testing
|
||||||
|
|
||||||
|
- [](integration-testing-using-virtual-machines)
|
||||||
|
|
||||||
|
## Deploying NixOS
|
||||||
|
|
||||||
|
- [](installing-nixos-on-a-raspberry-pi)
|
||||||
|
- [](deploying-nixos-using-terraform)
|
||||||
|
|
||||||
|
|
||||||
```{toctree}
|
```{toctree}
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
:hidden: true
|
||||||
nixos-configuration-on-vm.md
|
nixos-configuration-on-vm.md
|
||||||
integration-testing-using-virtual-machines.md
|
|
||||||
building-bootable-iso-image.md
|
building-bootable-iso-image.md
|
||||||
installing-nixos-on-a-raspberry-pi.md
|
|
||||||
continuous-integration-github-actions.md
|
|
||||||
building-and-running-docker-images.md
|
building-and-running-docker-images.md
|
||||||
|
integration-testing-using-virtual-machines.md
|
||||||
|
installing-nixos-on-a-raspberry-pi.md
|
||||||
deploying-nixos-using-terraform.md
|
deploying-nixos-using-terraform.md
|
||||||
```
|
```
|
||||||
|
|
Loading…
Reference in a new issue