Skip to content

Commit

Permalink
Merge pull request #106 from flox/preview
Browse files Browse the repository at this point in the history
 chore: Release 1.3.8
  • Loading branch information
mkenigs authored Dec 12, 2024
2 parents cd195c1 + 8b18d76 commit f0e2b8b
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 17 deletions.
2 changes: 1 addition & 1 deletion FLOX_VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
1.3.7
1.3.8
3 changes: 2 additions & 1 deletion docs/tutorials/default-environment.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,8 @@ or you can add a single line to your shell's RC file:

=== "Zsh"

Add the following line to the very end of your `.zshenv` file:
Add the following line to the very end of your `.zprofile` and `.zshrc`
files:

```bash
eval "$(flox activate -m run)"
Expand Down
24 changes: 9 additions & 15 deletions docs/tutorials/sharing-environments.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,39 +186,32 @@ Now all new windows will open into your [FloxHub][floxhub_concept] environment.

## Sharing with containers

Flox can render that environment as an OCI container runtime suitable for use with containerd, docker, kubernetes, nomad, and more.

!!! warning "`flox containerize` is currently experimental and only supported on Linux"
Flox can render that environment as an OCI container runtime suitable for use with containerd, Docker, Kubernetes, Nomad, and more.

Let's create a container image from the `example-environment` we have been working with.

To render your environment to a container, run `flox containerize`. This command
will pipe the container image to stdout for usage with `docker load`:
will automatically load the image into Docker:

``` { .console }
$ flox containerize | docker load # (1)!
$ flox containerize --runtime docker # (1)!
...
Building container...
Done.
No 'fromImage' provided
Creating layer 1 from paths: [...]
...
Adding manifests...
Done.
✨ Container written to '/home/youruser/default-container.tar.gz'
Loaded image: example-project:latest
✨ Container written to Docker runtime
```

1. `flox containerize` will stream generated docker image to `docker load`
command.
1. See [`flox containerize`][flox_containerize] for more output options.

!!! note "Why so many layers?"
By default flox splits every dependency into a different layers, which allows
By default Flox splits every dependency into a different layers, which allows
better dependency sharing and faster iteration.

Now let's run a command from our image:

``` console
$ docker run --rm -it flox-env-container -- telnet --version
$ docker run --rm -it example-project -- telnet --version
telnet (GNU inetutils) 2.5
...
```
Expand All @@ -235,3 +228,4 @@ telnet (GNU inetutils) 2.5
[environment_concept]: ../concepts/environments.md
[layering_guide]: ./layering-multiple-environments.md
[customizing_guide]: ./customizing-environments.md
[flox_containerize]: ../reference/command-reference/flox-containerize.md

0 comments on commit f0e2b8b

Please sign in to comment.