Go Mod Example + Doc Links (#1017)

## Summary

* Add a Go Mod Flake Example
* Add links back to our docs for some key examples

## How was it tested?

Markdown Only

Author: Lagoja

examples/README.md

@@ -5,6 +5,7 @@
 Example dev environments built with Devbox:
 
 1. `databases` - Examples of popular DBs (eg.,MariaDB, Postgres, Redis)
-2. `development` - Shells for developing in different programming languages
-2. `stacks` - Full projects and web stacks, like LAMP and Drupal
-3. `servers` - Examples of servers, like Apache + Nginx
+1. `development` - Shells for developing in different programming languages
+1. `flakes` - Examples of using Nix Flakes with Devbox
+1. `servers` - Examples of servers, like Apache + Nginx
+1. `stacks` - Full projects and web stacks, like LAMP and Drupal

examples/development/haskell/my-project/README.md

@@ -1,12 +1,14 @@
 # Haskell
 
-This example was generated using `stack`. To generate a similar example, you can copy the devbox json and run `devbox shell`. 
+This example was generated using `stack`. To generate a similar example, you can copy the devbox json and run `devbox shell`.
 
-Once your shell has activated, run: 
+Once your shell has activated, run:
 
 ```
 stack new my-project
 cd my-project
 stack build
 stack exec my-project-exe
 ```
+
+For more details, check out the [Haskell + Devbox Docs](https://www.jetpack.io/devbox/docs/devbox_examples/languages/haskell/)

examples/development/ruby/README.md

@@ -0,0 +1,8 @@
+# Ruby
+
+Basic Ruby "Hello World" example. For more details on how Ruby + Devbox works, check out our [docs page](https://www.jetpack.io/devbox/docs/devbox_examples/languages/ruby/).
+
+## Related Docs
+
+* [Rails + Devbox](https://www.jetpack.io/devbox/docs/devbox_examples/stacks/rails/)
+* [Jekyll + Devbox](https://www.jetpack.io/devbox/docs/devbox_examples/stacks/jekyll/)

examples/flakes/README.md

@@ -1,6 +1,8 @@
 # Flakes
 
-Examples that show how to add custom flakes to your devbox project.
+Examples that show how to add custom flakes to your Devbox project. These examples require [Devbox 0.4.7](https://www.jetpack.io/blog/devbox-0-4-7/) or later.
+
+For more details, you can also consult our Docs page on [using flakes](https://www.jetpack.io/devbox/docs/guides/using_flakes/)
 
 ## Local flakes (usually committed to your project)
 

examples/flakes/go-mod/.gitignore

@@ -0,0 +1 @@
+ory-cli/result/*

examples/flakes/go-mod/README.md

@@ -0,0 +1,20 @@
+# Building a Go Module with Flakes
+
+This flake shows how to build a custom Go module and add it to your Devbox project. In this case, we're building the [Ory CLI](https://github.com/ory/cli)
+
+This example uses `buildGoModule` from Nix to build the module as a package in our Flake. You can view the flake.nix file in the ory-cli folder to see a commented example of how this function is used.
+
+We import the ory CLI in our project by adding it to our packages in `devbox.json`:
+
+```json
+{
+  "packages": [
+    "path:ory-cli"
+  ],
+   ...
+}
+```
+
+Note: you will need [Devbox 0.4.7](https://www.jetpack.io/blog/devbox-0-4-7/) or later for this to work. You can use this as an example to create your own templates.
+
+For more details on using Flakes with Devbox, read our post on [Using Nix Flakes with Devbox](https://www.jetpack.io/blog/using-nix-flakes-with-devbox/)

examples/flakes/go-mod/devbox.json

@@ -0,0 +1,11 @@
+{
+  "packages": [
+    "path:ory-cli"
+  ],
+  "shell": {
+    "init_hook": null
+  },
+  "nixpkgs": {
+    "commit": "f80ac848e3d6f0c12c52758c0f25c10c97ca3b62"
+  }
+}

examples/flakes/go-mod/devbox.lock

@@ -0,0 +1,4 @@
+{
+  "lockfile_version": "1",
+  "packages": {}
+}

examples/flakes/go-mod/ory-cli/flake.lock

@@ -0,0 +1,59 @@
+{
+  description =
+    "This flake builds the Ory CLI using Nix's buildGoModule Function.";
+
+  inputs = {
+    nixpkgs.url = "nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+    # The Ory CLI is not a flake, so we have to use the Github input and build it ourselves.
+    ory-cli = {
+      type = "github";
+      owner = "ory";
+      repo = "cli";
+      ref = "v0.2.2";
+      flake = false;
+    };
+  };
+
+  outputs = { self, nixpkgs, flake-utils, ory-cli }:
+  # Use the flake-utils lib to easily create a multi-system flake
+  flake-utils.lib.eachDefaultSystem (system:
+    let
+      # Define some variables that we want to use in our package build. You'll want to update version and `ref` above to use a different version of Ory.
+      version = "0.2.2";
+    in {
+      packages = let
+          pkgs = import nixpkgs{inherit system;};
+          pname = "ory";
+          name = "ory-${version}";
+      in {
+        # Build the Ory CLI using Nix's buildGoModuleFunction
+        ory-cli = pkgs.buildGoModule {
+          inherit version;
+          inherit pname;
+          inherit name;
+
+          # Path to the source code we want to build. In this case, it's the `ory-cli` input we defined above.
+          src = ory-cli;
+
+          # This was in the Makefile in the Ory repo, not sure if it's required
+          tags = [ "sqlite"];
+
+          doCheck = false;
+
+          # If the vendor folder is not checked in, we have to provide a hash for the vendor folder. Nix requires this to ensure the vendor folder is reproducible, and matches what we expect.
+          vendorSha256 = "sha256-J9jyeLIT+1pFnHOUHrzmblVCJikvY05Sw9zMz5qaDOk=";
+
+          # The Go Mod is named `cli` by default, so we rename it to `ory`.
+          postInstall = ''
+            mv $out/bin/cli $out/bin/ory
+          '';
+        };
+      };
+
+      # Set Ory as the default package output for this flake
+      defaultPackage = self.packages.ory-cli;
+    }
+  );
+}
+