Compare commits
5 Commits
3180af5bd4
...
c5df43b3e7
| Author | SHA1 | Date |
|---|---|---|
 Massaki Archambault
|
c5df43b3e7 | |
|
Massaki Archambault
|
d1c82e1329 | |
|
Massaki Archambault
|
46217c1a9d | |
|
Massaki Archambault
|
d3e211e1cb | |
|
Massaki Archambault
|
53450730c9 |
|
|
@ -1,6 +0,0 @@
|
|||
FROM alpine
|
||||
|
||||
COPY ./bin/gitlabfs /usr/bin/gitlabfs
|
||||
|
||||
ENTRYPOINT ["gitlabfs"]
|
||||
|
||||
2
Makefile
2
Makefile
|
|
@ -1,4 +1,4 @@
|
|||
PROGRAM := gitlabfs
|
||||
PROGRAM := gitforgefs
|
||||
TARGET_DIR := ./bin
|
||||
VERSION := $(shell git describe --tags --always)
|
||||
|
||||
|
|
|
|||
145
README.md
145
README.md
|
|
@ -1,119 +1,94 @@
|
|||
# gitlabfs
|
||||
# gitforgefs
|
||||
|
||||
`gitlabfs` allows you to mount and navigate Gitlab groups and user personal projects as a FUSE filesystem with every groups represented as a folder and every projects represented as a symlink pointing on a local clone of the project.
|
||||
*Formerly gitlabfs*
|
||||
|
||||
Partial output of `tree`, truncated and with a max of 4 levels:
|
||||
`gitforgefs` allows you to mount and navigate git forges (Github, Gitlab, Gitea, etc.) as a [FUSE](https://github.com/libfuse/libfuse) filesystem with every groups, organization, and users represented as a folder and every repositories represented as a symlink pointing on a local clone of the project. This is helpful to automate the organization of your local clones.
|
||||
|
||||
To help illustrate, this is the output of `tree` in a filesystem exposing all the repositories of a github user.
|
||||
```
|
||||
$ tree -L 4
|
||||
$ tree
|
||||
.
|
||||
├── projects
|
||||
│ └── gitlab-org
|
||||
│ ├── 5-minute-production-app
|
||||
│ │ ├── deploy-template -> /home/marchambault/.local/share/gitlabfs/gitlab.com/22487050
|
||||
│ │ ├── examples
|
||||
│ │ ├── hipio -> /home/marchambault/.local/share/gitlabfs/gitlab.com/23344605
|
||||
│ │ ├── sandbox
|
||||
│ │ └── static-template -> /home/marchambault/.local/share/gitlabfs/gitlab.com/23203100
|
||||
│ ├── allocations -> /home/marchambault/.local/share/gitlabfs/gitlab.com/684698
|
||||
│ ├── apilab -> /home/marchambault/.local/share/gitlabfs/gitlab.com/2383700
|
||||
│ ├── architecture
|
||||
│ │ └── tasks -> /home/marchambault/.local/share/gitlabfs/gitlab.com/22351703
|
||||
│ ├── async-retrospectives -> /home/marchambault/.local/share/gitlabfs/gitlab.com/7937396
|
||||
│ ├── auto-deploy-app -> /home/marchambault/.local/share/gitlabfs/gitlab.com/6329546
|
||||
│ ├── auto-deploy-helm -> /home/marchambault/.local/share/gitlabfs/gitlab.com/3651684
|
||||
│ ├── auto-devops-v12-10 -> /home/marchambault/.local/share/gitlabfs/gitlab.com/18629149
|
||||
│ ├── backstage-changelog -> /home/marchambault/.local/share/gitlabfs/gitlab.com/7602162
|
||||
│ ├── blob-examples -> /home/marchambault/.local/share/gitlabfs/gitlab.com/3094319
|
||||
│ ├── build
|
||||
│ │ ├── CNG -> /home/marchambault/.local/share/gitlabfs/gitlab.com/4359271
|
||||
│ │ ├── CNG-mirror -> /home/marchambault/.local/share/gitlabfs/gitlab.com/7682093
|
||||
│ │ ├── dsop-scripts -> /home/marchambault/.local/share/gitlabfs/gitlab.com/19310217
|
||||
│ │ ├── omnibus-mirror
|
||||
│ │ └── tr-test-dependency-proxy -> /home/marchambault/.local/share/gitlabfs/gitlab.com/20085049
|
||||
│ ├── charts
|
||||
│ │ ├── apparmor -> /home/marchambault/.local/share/gitlabfs/gitlab.com/18991900
|
||||
│ │ ├── auto-deploy-app -> /home/marchambault/.local/share/gitlabfs/gitlab.com/11915984
|
||||
│ │ ├── components
|
||||
│ │ ├── consul -> /home/marchambault/.local/share/gitlabfs/gitlab.com/18663049
|
||||
│ │ ├── deploy-image-helm-base -> /home/marchambault/.local/share/gitlabfs/gitlab.com/7453181
|
||||
│ │ ├── elastic-stack -> /home/marchambault/.local/share/gitlabfs/gitlab.com/18439881
|
||||
│ │ ├── fluentd-elasticsearch -> /home/marchambault/.local/share/gitlabfs/gitlab.com/17253921
|
||||
│ │ ├── gitlab -> /home/marchambault/.local/share/gitlabfs/gitlab.com/3828396
|
||||
│ │ ├── gitlab-runner -> /home/marchambault/.local/share/gitlabfs/gitlab.com/6329679
|
||||
│ │ ├── knative -> /home/marchambault/.local/share/gitlabfs/gitlab.com/16590122
|
||||
│ │ └── plantuml -> /home/marchambault/.local/share/gitlabfs/gitlab.com/14372596
|
||||
│ [...]
|
||||
└── users
|
||||
└── badjware
|
||||
└── test_project -> /home/marchambault/.local/share/gitlabfs/gitlab.com/23370783
|
||||
└── badjware
|
||||
├── aws-cloud-gaming -> /home/marchambault/.local/share/gitforgefs/github.com/257091317
|
||||
├── certbot -> /home/marchambault/.local/share/gitforgefs/github.com/122014287
|
||||
├── certbot-dns-cpanel -> /home/marchambault/.local/share/gitforgefs/github.com/131224547
|
||||
├── certbot-dns-ispconfig -> /home/marchambault/.local/share/gitforgefs/github.com/227005814
|
||||
├── CommonLibVR -> /home/marchambault/.local/share/gitforgefs/github.com/832968971
|
||||
├── community -> /home/marchambault/.local/share/gitforgefs/github.com/424689724
|
||||
├── docker-postal -> /home/marchambault/.local/share/gitforgefs/github.com/132605640
|
||||
├── dotfiles -> /home/marchambault/.local/share/gitforgefs/github.com/192993195
|
||||
├── ecommerce-exporter -> /home/marchambault/.local/share/gitforgefs/github.com/562583906
|
||||
├── FightClub5eXML -> /home/marchambault/.local/share/gitforgefs/github.com/246177579
|
||||
├── gitforgefs -> /home/marchambault/.local/share/gitforgefs/github.com/324617595
|
||||
├── kustomize-plugins -> /home/marchambault/.local/share/gitforgefs/github.com/263480122
|
||||
├── librechat-mistral -> /home/marchambault/.local/share/gitforgefs/github.com/753193720
|
||||
├── PapyrusExtenderSSE -> /home/marchambault/.local/share/gitforgefs/github.com/832969611
|
||||
├── Parsec-Cloud-Preparation-Tool -> /home/marchambault/.local/share/gitforgefs/github.com/258052650
|
||||
├── po3-Tweaks -> /home/marchambault/.local/share/gitforgefs/github.com/832969112
|
||||
├── prometheus-ecs-discovery -> /home/marchambault/.local/share/gitforgefs/github.com/187891900
|
||||
├── simplefuse -> /home/marchambault/.local/share/gitforgefs/github.com/111226611
|
||||
├── tmux-continuum -> /home/marchambault/.local/share/gitforgefs/github.com/160746043
|
||||
├── ttyd -> /home/marchambault/.local/share/gitforgefs/github.com/132514236
|
||||
├── usb-libvirt-hotplug -> /home/marchambault/.local/share/gitforgefs/github.com/128696299
|
||||
└── vfio-win10 -> /home/marchambault/.local/share/gitforgefs/github.com/388475049
|
||||
|
||||
696 directories, 0 files
|
||||
24 directories, 0 files
|
||||
```
|
||||
|
||||
## Supported forges
|
||||
|
||||
Currently, the following forges are supported:
|
||||
|
||||
| Forge | Name in configuration | API token permissions, if using an API key |
|
||||
| ------------------------------- | --------------------- | ------------------------------------------------------ |
|
||||
| [Gitlab](https://gitlab.com) | `gitlab` | `read_user`, `read_api` |
|
||||
| [Github](https://github.com) | `github` | `repo` |
|
||||
| [Gitea](https://gitea.com) | `gitea` | organization: `read`, repository: `read`, user: `read` |
|
||||
| [Forgejo](https://forgejo.org/) | `gitea` | organization: `read`, repository: `read`, user: `read` |
|
||||
|
||||
Merge requests to add support to other forges are welcome.
|
||||
|
||||
## Install
|
||||
|
||||
Install [go](https://golang.org/) and run
|
||||
``` sh
|
||||
go install github.com/badjware/gitlabfs@latest
|
||||
go install github.com/badjware/gitforgefs
|
||||
```
|
||||
|
||||
The executable will be in `$GOPATH/bin/gitlabfs` or `~/go/bin/gitlabfs` by default. For convenience, copy `gitlabfs` somewhere suitable or add `~/go/bin` in your `PATH`.
|
||||
The executable will be in `$GOPATH/bin/gitforgefs` or `~/go/bin/gitforgefs` by default. For convenience, add `~/go/bin` in your `$PATH` if not done already.
|
||||
|
||||
## Usage
|
||||
|
||||
Download the [example configuration file](./config.example.yaml) and edit the default configuration to suit your needs.
|
||||
|
||||
### Getting an API token
|
||||
|
||||
To generate an api token, log into your Gitlab instance, and go in your user settings > Access Token. Create a personal access token with the following permissions at the minimum:
|
||||
* `read_user`
|
||||
* `read_api`
|
||||
|
||||
### Getting the group ids
|
||||
|
||||
The group id can be seen just under the name of the group in Gitlab.
|
||||
|
||||
|
||||
|
||||
### Getting the user ids
|
||||
|
||||
Log into gitlab and go to https://gitlab.com/api/v4/users?username=USERNAME where `USERNAME` is the username of the user you wish to know the id of. The json response will contain the user id.
|
||||
|
||||
See https://forum.gitlab.com/t/where-is-my-user-id-in-gitlab-com/7912
|
||||
|
||||
### Mounting the filesystem
|
||||
|
||||
You can mount the filesystem with the following command:
|
||||
Then, you can run gitforgefs as follows:
|
||||
``` sh
|
||||
~/go/bin/gitlabfs -config /path/to/your/config.yaml /path/to/mountpoint
|
||||
gitforgefs -config config.yaml /path/to/mountpoint
|
||||
```
|
||||
Once the filesystem is mounted, you can `cd` into it and navigate it like any other filesystem. The first time `ls` is run the list of groups and projects is fetched from Gitlab. This operation can take a few seconds and the command will appear frozen until it's completed. Subsequent `ls` will fetch from the cache and should be much faster.
|
||||
|
||||
If `on_clone` is set to `init` or `no-checkout`, the locally cloned project will appear empty. Simply running `git pull` manually in the project folder will sync it up with Gitlab.
|
||||
|
||||
### Unmounting the filesystem
|
||||
|
||||
To stop the filesystem, use the command `umount /path/to/mountpoint` to cleanly unmount the filesystem.
|
||||
|
||||
If `gitlabfs` is not cleanly stopped, you might start seeing the error "transport endpoint is not connected" when trying to access the mountpoint, even preventing from mounting back the filesystem on the same mountpoint. To fix this, use `umount` as root user, eg: `sudo umount /path/to/mountpoint`.
|
||||
Stopping gitforgefs will unmount the filesystem. In the event the mountpoint is stuck in a bad state (eg: due to receiving a SIGKILL), you may need to manually cleanup using `umount`:
|
||||
``` sh
|
||||
sudo umount /path/to/mountpoint
|
||||
```
|
||||
|
||||
### Running automatically on user login
|
||||
|
||||
See [./contrib/systemd](contrib/systemd) for instructions on how to configure a systemd service to automatically run gitlabfs on user login.
|
||||
See [./contrib/systemd](contrib/systemd) for instructions on how to configure a systemd service to automatically run gitforgefs on user login.
|
||||
|
||||
## Caching
|
||||
|
||||
To reduce the number of calls to the Gitlab api and improve the responsiveness of the filesystem, `gitlabfs` will cache the content of the group in memory. If a group or project is renamed, created or deleted from Gitlab, these change will not appear in the filesystem. To force `gitlabfs` to refresh its cache, use `touch .refresh` in the folder to refresh to force `gitlabfs` to query Gitlab for the list of groups and projects again.
|
||||
### Filesystem cache
|
||||
|
||||
While the filesystem lives in memory, the git repositories that are cloned are saved on disk. By default, they are saved in `$XDG_DATA_HOME/gitlabfs` or `$HOME/.local/share/gitlabfs`, if `$XDG_DATA_HOME` is unset. `gitlabfs` symlink to the local clone of that repo. The local clone is unaffected by project rename or archive/unarchive in Gitlab and a given project will always point to the correct local folder.
|
||||
To reduce the number of calls to the APIs and improve the responsiveness of the filesystem, gitforgefs will cache the content of the forge in memory. If a group or project is renamed, created or deleted from the forge, these change will not appear in the filesystem immediately. To force gitforgefs to refresh its cache, use `touch .refresh` in the folder to signal gitforgefs to refresh this folder.
|
||||
|
||||
## Known issues / Future improvements
|
||||
* Cache persists forever until a manual refresh is requested. Some way to automatically refresh would be nice.
|
||||
* The filesystem is currently read-only. Implementing `mkdir` to create groups, `ln` or `touch` to create projects, etc. would be nice.
|
||||
* Code need some cleanup and could maybe be optimized here and there.
|
||||
### Local repository cache
|
||||
|
||||
## Building
|
||||
While the filesystem lives in memory, the git repositories that are cloned are saved on disk. By default, they are saved in `$XDG_DATA_HOME/gitforgefs` or `$HOME/.local/share/gitforgefs`, if `$XDG_DATA_HOME` is unset. `gitforgefs` symlink to the local clone of that repo. The local clone is unaffected by project rename or archive/unarchive in Gitlab and a given project will always point to the correct local folder.
|
||||
|
||||
## Future improvements
|
||||
* Cache persists forever until a manual refresh is requested. Some way to automatically refresh after a timeout would be nice.
|
||||
|
||||
## Building from the repo
|
||||
|
||||
Simply use `make` to create the executable. The executable will be in `bin/`.
|
||||
|
||||
|
|
|
|||
|
|
@ -28,8 +28,8 @@ gitlab:
|
|||
group_ids:
|
||||
- 9970 # gitlab-org
|
||||
|
||||
# A list of the user ids to expose their personal projects in the filesystem.
|
||||
user_ids: []
|
||||
# A list of the name of the user to expose their repositories un the filesystem
|
||||
user_names: []
|
||||
|
||||
# Set how archived projects are handled.
|
||||
# If set to "show", it will add them to the filesystem and treat them like any other project
|
||||
|
|
@ -102,7 +102,7 @@ gitea:
|
|||
|
||||
git:
|
||||
# Path to the local repository cache. Repositories in the filesystem will symlink to a folder in this path.
|
||||
# Default to $XDG_DATA_HOME/gitlabfs, or $HOME/.local/share/gitlabfs if the environment variable $XDG_DATA_HOME is unset.
|
||||
# Default to $XDG_DATA_HOME/gitforgefs, or $HOME/.local/share/gitforgefs if the environment variable $XDG_DATA_HOME is unset.
|
||||
#clone_location:
|
||||
|
||||
# The name of the remote in the local clone.
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
fs:
|
||||
mountpoint: /tmp/gitlabfs/test/mnt/gitlab
|
||||
mountpoint: /tmp/gitforgefs/test/mnt/gitlab
|
||||
mountoptions: nodev
|
||||
forge: gitlab
|
||||
|
||||
|
|
@ -9,8 +9,8 @@ gitlab:
|
|||
pull_method: ssh
|
||||
group_ids:
|
||||
- 123
|
||||
user_ids:
|
||||
- 456
|
||||
user_names:
|
||||
- test-user
|
||||
archived_project_handling: hide
|
||||
include_current_user: true
|
||||
|
||||
|
|
@ -36,7 +36,7 @@ gitea:
|
|||
include_current_user: true
|
||||
|
||||
git:
|
||||
clone_location: /tmp/gitlabfs/test/cache/gitlab
|
||||
clone_location: /tmp/gitforgefs/test/cache/gitlab
|
||||
remote: origin
|
||||
on_clone: clone
|
||||
auto_pull: false
|
||||
|
|
|
|||
|
|
@ -38,8 +38,8 @@ type (
|
|||
URL string `yaml:"url,omitempty"`
|
||||
Token string `yaml:"token,omitempty"`
|
||||
|
||||
GroupIDs []int `yaml:"group_ids,omitempty"`
|
||||
UserIDs []int `yaml:"user_ids,omitempty"`
|
||||
GroupIDs []int `yaml:"group_ids,omitempty"`
|
||||
UserNames []string `yaml:"user_ids,omitempty"`
|
||||
|
||||
ArchivedProjectHandling string `yaml:"archived_project_handling,omitempty"`
|
||||
IncludeCurrentUser bool `yaml:"include_current_user,omitempty"`
|
||||
|
|
@ -83,7 +83,7 @@ func LoadConfig(configPath string) (*Config, error) {
|
|||
if dataHome == "" {
|
||||
dataHome = filepath.Join(os.Getenv("HOME"), ".local/share")
|
||||
}
|
||||
defaultCloneLocation := filepath.Join(dataHome, "gitlabfs")
|
||||
defaultCloneLocation := filepath.Join(dataHome, "gitforgefs")
|
||||
|
||||
config := &Config{
|
||||
FS: FSConfig{
|
||||
|
|
@ -96,7 +96,7 @@ func LoadConfig(configPath string) (*Config, error) {
|
|||
Token: "",
|
||||
PullMethod: "http",
|
||||
GroupIDs: []int{9970},
|
||||
UserIDs: []int{},
|
||||
UserNames: []string{},
|
||||
ArchivedProjectHandling: "hide",
|
||||
IncludeCurrentUser: true,
|
||||
},
|
||||
|
|
@ -119,17 +119,15 @@ func LoadConfig(configPath string) (*Config, error) {
|
|||
},
|
||||
}
|
||||
|
||||
if configPath != "" {
|
||||
f, err := os.Open(configPath)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to open config file: %v", err)
|
||||
}
|
||||
defer f.Close()
|
||||
f, err := os.Open(configPath)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to open config file: %v", err)
|
||||
}
|
||||
defer f.Close()
|
||||
|
||||
d := yaml.NewDecoder(f)
|
||||
if err := d.Decode(config); err != nil {
|
||||
return nil, fmt.Errorf("failed to parse config file: %v", err)
|
||||
}
|
||||
d := yaml.NewDecoder(f)
|
||||
if err := d.Decode(config); err != nil {
|
||||
return nil, fmt.Errorf("failed to parse config file: %v", err)
|
||||
}
|
||||
|
||||
// validate forge is set
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ import (
|
|||
"reflect"
|
||||
"testing"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
)
|
||||
|
||||
func TestLoadConfig(t *testing.T) {
|
||||
|
|
@ -16,7 +16,7 @@ func TestLoadConfig(t *testing.T) {
|
|||
input: "config.test.yaml",
|
||||
expected: &config.Config{
|
||||
FS: config.FSConfig{
|
||||
Mountpoint: "/tmp/gitlabfs/test/mnt/gitlab",
|
||||
Mountpoint: "/tmp/gitforgefs/test/mnt/gitlab",
|
||||
MountOptions: "nodev",
|
||||
Forge: "gitlab",
|
||||
},
|
||||
|
|
@ -25,7 +25,7 @@ func TestLoadConfig(t *testing.T) {
|
|||
Token: "12345",
|
||||
PullMethod: "ssh",
|
||||
GroupIDs: []int{123},
|
||||
UserIDs: []int{456},
|
||||
UserNames: []int{456},
|
||||
ArchivedProjectHandling: "hide",
|
||||
IncludeCurrentUser: true,
|
||||
},
|
||||
|
|
@ -47,7 +47,7 @@ func TestLoadConfig(t *testing.T) {
|
|||
IncludeCurrentUser: true,
|
||||
},
|
||||
Git: config.GitClientConfig{
|
||||
CloneLocation: "/tmp/gitlabfs/test/cache/gitlab",
|
||||
CloneLocation: "/tmp/gitforgefs/test/cache/gitlab",
|
||||
Remote: "origin",
|
||||
OnClone: "clone",
|
||||
AutoPull: false,
|
||||
|
|
@ -148,7 +148,7 @@ func TestMakeGitlabConfig(t *testing.T) {
|
|||
PullMethod: "http",
|
||||
Token: "",
|
||||
GroupIDs: []int{9970},
|
||||
UserIDs: []int{},
|
||||
UserNames: []int{},
|
||||
ArchivedProjectHandling: "hide",
|
||||
IncludeCurrentUser: true,
|
||||
},
|
||||
|
|
@ -158,7 +158,7 @@ func TestMakeGitlabConfig(t *testing.T) {
|
|||
PullMethod: "http",
|
||||
Token: "",
|
||||
GroupIDs: []int{9970},
|
||||
UserIDs: []int{},
|
||||
UserNames: []int{},
|
||||
ArchivedProjectHandling: "hide",
|
||||
IncludeCurrentUser: true,
|
||||
},
|
||||
|
|
@ -173,7 +173,7 @@ func TestMakeGitlabConfig(t *testing.T) {
|
|||
PullMethod: "invalid",
|
||||
Token: "",
|
||||
GroupIDs: []int{9970},
|
||||
UserIDs: []int{},
|
||||
UserNames: []int{},
|
||||
ArchivedProjectHandling: "hide",
|
||||
IncludeCurrentUser: true,
|
||||
},
|
||||
|
|
@ -187,7 +187,7 @@ func TestMakeGitlabConfig(t *testing.T) {
|
|||
PullMethod: "http",
|
||||
Token: "",
|
||||
GroupIDs: []int{9970},
|
||||
UserIDs: []int{},
|
||||
UserNames: []int{},
|
||||
IncludeCurrentUser: true,
|
||||
ArchivedProjectHandling: "invalid",
|
||||
},
|
||||
|
|
|
|||
|
|
@ -1,12 +1,15 @@
|
|||
This unit file allows you to automatically start gitlabfs as a systemd unit.
|
||||
This unit file allows you to automatically start gitforgefs as a systemd unit.
|
||||
|
||||
## Install
|
||||
1. Install gitlabfs using `go get`
|
||||
2. Run `which gitlabfs` to verify that gitlabfs is present in your PATH. if the command fail, you may need to add **$HOME/go/bin** to your PATH.
|
||||
3. Copy **gitlabfs@.service** into **~/.config/systemd/user**. Create the folder if it does not exists.
|
||||
4. Reload systemd: `systemctl --user daemon-reload`
|
||||
## Setup
|
||||
1. Install gitforgefs
|
||||
2. Copy **gitforgefs@.service** into **$HOME/.config/systemd/user**. Create the folder if it does not exists.
|
||||
``` sh
|
||||
mkdir -p $HOME/.config/systemd/user
|
||||
curl -o $HOME/.config/systemd/user/gitforgefs@.service https://raw.githubusercontent.com/badjware/gitlabfs/dev/contrib/systemd/gitforgefs%40.service
|
||||
```
|
||||
3. Reload systemd: `systemctl --user daemon-reload`
|
||||
|
||||
## Usage
|
||||
1. Create your gitlabfs config file in **~/.config/gitlabfs** eg: **~/.config/gitlabfs/gitlab.com.yaml**. Make sure the config file name ends with **.yaml** and a mountpoint is configured in the file.
|
||||
2. Start your service with `systemctl --user start gitlabfs@<name of your config>.service`. eg: `systemctl --user start gitlabfs@gitlab.com.service`. Omit the **.yaml** in the name of the service.
|
||||
3. Enable your service start on login with `systemctl --user enable gitlabfs@<name of your config>.service`. eg: `systemctl --user enable gitlabfs@gitlab.com.service`
|
||||
1. Create your gitforgefs config file in **$HOME/.config/gitforgefs** eg: **$HOME/.config/gitforgefs/gitlab.com.yaml**. Make sure the config file name ends with **.yaml** and a mountpoint is configured in the file.
|
||||
2. Start your service with `systemctl --user start gitforgefs@<name of your config>.service`. eg: `systemctl --user start gitforgefs@gitlab.com.service`. Omit the **.yaml** extension.
|
||||
3. Enable your service to start on login with `systemctl --user enable gitforgefs@<name of your config>.service`. eg: `systemctl --user enable gitforgefs@gitlab.com.service`
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ Wants=network-online.target
|
|||
After=network-online.target
|
||||
|
||||
[Service]
|
||||
ExecStart=%h/go/bin/gitlabfs -config %E/gitlabfs/%i.yaml
|
||||
ExecStart=%h/go/bin/gitforgefs -config %E/gitforgefs/%i.yaml
|
||||
|
||||
[Install]
|
||||
WantedBy=default.target
|
||||
|
|
@ -6,8 +6,8 @@ import (
|
|||
"sync"
|
||||
|
||||
"code.gitea.io/sdk/gitea"
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
)
|
||||
|
||||
type giteaClient struct {
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ import (
|
|||
"sync"
|
||||
|
||||
"code.gitea.io/sdk/gitea"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
)
|
||||
|
||||
type Organization struct {
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ import (
|
|||
"path"
|
||||
|
||||
"code.gitea.io/sdk/gitea"
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
)
|
||||
|
||||
type Repository struct {
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ import (
|
|||
"sync"
|
||||
|
||||
"code.gitea.io/sdk/gitea"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
)
|
||||
|
||||
type User struct {
|
||||
|
|
|
|||
|
|
@ -6,8 +6,8 @@ import (
|
|||
"log/slog"
|
||||
"sync"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/google/go-github/v63/github"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ import (
|
|||
"fmt"
|
||||
"sync"
|
||||
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/google/go-github/v63/github"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ package github
|
|||
import (
|
||||
"path"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/google/go-github/v63/github"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ import (
|
|||
"fmt"
|
||||
"sync"
|
||||
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/google/go-github/v63/github"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -6,8 +6,8 @@ import (
|
|||
"slices"
|
||||
"sync"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/xanzy/go-gitlab"
|
||||
)
|
||||
|
||||
|
|
@ -19,6 +19,8 @@ type gitlabClient struct {
|
|||
|
||||
rootContent map[string]fstree.GroupSource
|
||||
|
||||
userIDs []int
|
||||
|
||||
// API response cache
|
||||
groupCacheMux sync.RWMutex
|
||||
groupCache map[int]*Group
|
||||
|
|
@ -43,6 +45,8 @@ func NewClient(logger *slog.Logger, config config.GitlabClientConfig) (*gitlabCl
|
|||
|
||||
rootContent: nil,
|
||||
|
||||
userIDs: []int{},
|
||||
|
||||
groupCache: map[int]*Group{},
|
||||
userCache: map[int]*User{},
|
||||
}
|
||||
|
|
@ -52,7 +56,17 @@ func NewClient(logger *slog.Logger, config config.GitlabClientConfig) (*gitlabCl
|
|||
if err != nil {
|
||||
logger.Warn("failed to fetch the current user:", "error", err.Error())
|
||||
} else {
|
||||
gitlabClient.UserIDs = append(gitlabClient.UserIDs, currentUser.ID)
|
||||
gitlabClient.userIDs = append(gitlabClient.userIDs, currentUser.ID)
|
||||
}
|
||||
|
||||
// Fetch the configured users and add them to the list
|
||||
for _, userName := range config.UserNames {
|
||||
user, _, err := client.Users.ListUsers(&gitlab.ListUsersOptions{Username: &userName})
|
||||
if err != nil || len(user) != 1 {
|
||||
logger.Warn("failed to fetch the user", "userName", userName, "error", err.Error())
|
||||
} else {
|
||||
gitlabClient.userIDs = append(gitlabClient.userIDs, user[0].ID)
|
||||
}
|
||||
}
|
||||
|
||||
return gitlabClient, nil
|
||||
|
|
@ -72,7 +86,7 @@ func (c *gitlabClient) FetchRootGroupContent() (map[string]fstree.GroupSource, e
|
|||
rootGroupCache[group.Name] = group
|
||||
}
|
||||
// fetch users
|
||||
for _, uid := range c.UserIDs {
|
||||
for _, uid := range c.userIDs {
|
||||
user, err := c.fetchUser(uid)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
|
|
@ -86,7 +100,7 @@ func (c *gitlabClient) FetchRootGroupContent() (map[string]fstree.GroupSource, e
|
|||
}
|
||||
|
||||
func (c *gitlabClient) FetchGroupContent(gid uint64) (map[string]fstree.GroupSource, map[string]fstree.RepositorySource, error) {
|
||||
if slices.Contains[[]int, int](c.UserIDs, int(gid)) {
|
||||
if slices.Contains[[]int, int](c.userIDs, int(gid)) {
|
||||
// gid is a user
|
||||
user, err := c.fetchUser(int(gid))
|
||||
if err != nil {
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ import (
|
|||
"fmt"
|
||||
"sync"
|
||||
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/xanzy/go-gitlab"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ package gitlab
|
|||
import (
|
||||
"path"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/xanzy/go-gitlab"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ import (
|
|||
"fmt"
|
||||
"sync"
|
||||
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/xanzy/go-gitlab"
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -10,9 +10,9 @@ import (
|
|||
"strconv"
|
||||
"time"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitlabfs/utils"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/badjware/gitforgefs/utils"
|
||||
"github.com/vmihailenco/taskq/v3"
|
||||
"github.com/vmihailenco/taskq/v3/memqueue"
|
||||
)
|
||||
|
|
@ -41,7 +41,7 @@ func NewClient(logger *slog.Logger, p config.GitClientConfig) (*gitClient, error
|
|||
|
||||
logger: logger,
|
||||
|
||||
hostnameProg: regexp.MustCompile(`([a-z0-1:\-]+\.)+[a-z0-1:\-]+`),
|
||||
hostnameProg: regexp.MustCompile(`([a-z0-1\-]+\.)+[a-z0-1\-]+`),
|
||||
|
||||
queue: queueFactory.RegisterQueue(&taskq.QueueOptions{
|
||||
Name: "git-queue",
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ import (
|
|||
"fmt"
|
||||
"strconv"
|
||||
|
||||
"github.com/badjware/gitlabfs/utils"
|
||||
"github.com/badjware/gitforgefs/utils"
|
||||
)
|
||||
|
||||
func (c *gitClient) clone(url string, defaultBranch string, dst string) error {
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ import (
|
|||
"fmt"
|
||||
"strconv"
|
||||
|
||||
"github.com/badjware/gitlabfs/utils"
|
||||
"github.com/badjware/gitforgefs/utils"
|
||||
)
|
||||
|
||||
func (c *gitClient) pull(repoPath string, defaultBranch string) error {
|
||||
|
|
|
|||
2
go.mod
2
go.mod
|
|
@ -1,4 +1,4 @@
|
|||
module github.com/badjware/gitlabfs
|
||||
module github.com/badjware/gitforgefs
|
||||
|
||||
go 1.21
|
||||
|
||||
|
|
|
|||
14
main.go
14
main.go
|
|
@ -7,16 +7,16 @@ import (
|
|||
"os"
|
||||
"strings"
|
||||
|
||||
"github.com/badjware/gitlabfs/config"
|
||||
"github.com/badjware/gitlabfs/forges/gitea"
|
||||
"github.com/badjware/gitlabfs/forges/github"
|
||||
"github.com/badjware/gitlabfs/forges/gitlab"
|
||||
"github.com/badjware/gitlabfs/fstree"
|
||||
"github.com/badjware/gitlabfs/git"
|
||||
"github.com/badjware/gitforgefs/config"
|
||||
"github.com/badjware/gitforgefs/forges/gitea"
|
||||
"github.com/badjware/gitforgefs/forges/github"
|
||||
"github.com/badjware/gitforgefs/forges/gitlab"
|
||||
"github.com/badjware/gitforgefs/fstree"
|
||||
"github.com/badjware/gitforgefs/git"
|
||||
)
|
||||
|
||||
func main() {
|
||||
configPath := flag.String("config", "", "The config file")
|
||||
configPath := flag.String("config", "config.yaml", "The config file")
|
||||
mountoptionsFlag := flag.String("o", "", "Filesystem mount options. See mount.fuse(8)")
|
||||
debug := flag.Bool("debug", false, "Enable debug logging")
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue