Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(install): use ssh keys for private git repos #11917

Merged
merged 18 commits into from
Jun 21, 2024
Merged
Show file tree
Hide file tree
Changes from 16 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/cli/add.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,12 +117,16 @@ Bun reads this field and will run lifecycle scripts for `my-trusted-package`.

## Git dependencies

To add a dependency from a git repository:
To add a dependency from a public or private git repository:

```bash
$ bun add git@github.com:moment/moment.git
```

{% callout %}
**Note** — To install private repositories, your system needs the appropriate SSH credentials to access the repository.
{% /callout %}

Bun supports a variety of protocols, including [`github`](https://docs.npmjs.com/cli/v9/configuring-npm/package-json#github-urls), [`git`](https://docs.npmjs.com/cli/v9/configuring-npm/package-json#git-urls-as-dependencies), `git+ssh`, `git+https`, and many more.

```json
Expand Down
2 changes: 1 addition & 1 deletion src/env_loader.zig
Original file line number Diff line number Diff line change
Expand Up @@ -1270,7 +1270,7 @@ pub const Map = struct {
}

pub fn remove(this: *Map, key: string) void {
this.map.remove(key);
_ = this.map.swapRemove(key);
Eckhardt-D marked this conversation as resolved.
Show resolved Hide resolved
}

pub fn cloneWithAllocator(this: *const Map, new_allocator: std.mem.Allocator) !Map {
Expand Down
5 changes: 5 additions & 0 deletions src/install/dependency.zig
Original file line number Diff line number Diff line change
Expand Up @@ -577,6 +577,11 @@ pub const Version = struct {
}
}


if (url.len > 4 and strings.eqlComptime(url[0.."git@".len], "git@")) {
url = url["git@".len..];
}

if (strings.indexOfChar(url, '.')) |dot| {
if (Repository.Hosts.has(url[0..dot])) return .git;
}
Expand Down
25 changes: 22 additions & 3 deletions src/install/install.zig
Original file line number Diff line number Diff line change
Expand Up @@ -754,6 +754,7 @@ pub const Task = struct {
.git_clone => {
const name = this.request.git_clone.name.slice();
const url = this.request.git_clone.url.slice();
var attempt: u8 = 1;
const dir = brk: {
if (Repository.tryHTTPS(url)) |https| break :brk Repository.download(
manager.allocator,
Expand All @@ -763,25 +764,43 @@ pub const Task = struct {
this.id,
name,
https,
) catch null;
attempt
) catch |err| {
// Exit early if git checked and could
// not find the repository, skip ssh
if (err == error.RepositoryNotFound) {
this.err = err;
this.status = Status.fail;
this.data = .{ .git_clone = bun.invalid_fd };

return;
}

attempt += 1;
break :brk null;
};
break :brk null;
} orelse Repository.download(
} orelse if (Repository.trySSH(url)) |ssh| Repository.download(
manager.allocator,
manager.env,
manager.log,
manager.getCacheDirectory(),
this.id,
name,
url,
ssh,
attempt
) catch |err| {
this.err = err;
this.status = Status.fail;
this.data = .{ .git_clone = bun.invalid_fd };

return;
} else {
return;
};

manager.git_repositories.put(manager.allocator, this.id, bun.toFD(dir.fd)) catch unreachable;

this.data = .{
.git_clone = bun.toFD(dir.fd),
};
Expand Down
108 changes: 88 additions & 20 deletions src/install/repository.zig
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ const GitSHA = String;
const Path = bun.path;

threadlocal var final_path_buf: bun.PathBuffer = undefined;
threadlocal var ssh_path_buf: bun.PathBuffer = undefined;
threadlocal var folder_name_buf: bun.PathBuffer = undefined;
threadlocal var json_path_buf: bun.PathBuffer = undefined;

Expand Down Expand Up @@ -45,6 +46,7 @@ pub const Repository = extern struct {
const version_literal = dep.version.literal.slice(buf);
const repo_name = repository.repo;
const repo_name_str = lockfile.str(&repo_name);

if (repo_name_str.len == 0) {
const name_buf = allocator.alloc(u8, bun.sha.EVP.SHA1.digest) catch bun.outOfMemory();
var sha1 = bun.sha.SHA1.init();
Expand Down Expand Up @@ -151,8 +153,27 @@ pub const Repository = extern struct {
env: *DotEnv.Loader,
argv: []const string,
) !string {
// Note: currently if the user sets this to some value that causes
// a prompt for a password, the stdout of the prompt will be masked
// by further output of the rest of the install process.
// A value can still be entered, but we need to find a workaround
// so the user can see what is being prompted. By default the settings
// below will cause no prompt and throw instead.
const originalAskPass = env.map.get("GIT_ASKPASS");
const originalSSHCommand = env.map.get("GIT_SSH_COMMAND");

try env.map.putAllocKeyAndValue(allocator, "GIT_ASKPASS", "echo");
try env.map.putAllocKeyAndValue(allocator, "GIT_SSH_COMMAND", "ssh -oStrictHostKeyChecking=accept-new");

var std_map = try env.map.stdEnvMap(allocator);
defer std_map.deinit();

defer {
_ = if (originalAskPass) |value| env.map.put(allocator, "GIT_ASKPASS", value) catch void else env.map.remove("GIT_ASKPASS");

_ = if (originalSSHCommand) |value| env.map.put(allocator, "GIT_SSH_COMMAND", value) catch void else env.map.remove("GIT_SSH_COMMAND");

std_map.deinit();
}

const result = if (comptime Environment.isWindows)
try std.process.Child.run(.{
Expand All @@ -168,17 +189,66 @@ pub const Repository = extern struct {
});

switch (result.term) {
.Exited => |sig| if (sig == 0) return result.stdout,
.Exited => |sig| if (sig == 0) return result.stdout else if (
// remote: The page could not be found <-- for non git
// remote: Repository not found. <-- for git
// remote: fatal repository '<url>' does not exist <-- for git
(strings.containsComptime(result.stderr, "remote:") and strings.containsComptime(result.stderr, "not") and strings.containsComptime(result.stderr, "found")) or strings.containsComptime(result.stderr, "does not exist")) {
return error.RepositoryNotFound;
},
else => {},
}

return error.InstallFailed;
}

pub fn trySSH(url: string) ?string {
// Do not cast explicit http(s) URLs to SSH
if (strings.hasPrefixComptime(url, "http")) {
return null;
}

if (strings.hasPrefixComptime(url, "git@") or strings.hasPrefixComptime(url, "ssh://")) {
return url;
}

if (Dependency.isSCPLikePath(url)) {
ssh_path_buf[0.."ssh://git@".len].* = "ssh://git@".*;
var rest = ssh_path_buf["ssh://git@".len..];

const colon_index = strings.indexOfChar(url, ':');

if (colon_index) |colon| {
// make sure known hosts have `.com` or `.org`
if (Hosts.get(url[0..colon])) |tld| {
bun.copy(u8, rest, url[0..colon]);
bun.copy(u8, rest[colon..], tld);
rest[colon + tld.len] = '/';
bun.copy(u8, rest[colon + tld.len + 1 ..], url[colon + 1 ..]);
const out = ssh_path_buf[0 .. url.len + "ssh://git@".len + tld.len];
return out;
}
}

bun.copy(u8, rest, url);
if (colon_index) |colon| rest[colon] = '/';
const final = ssh_path_buf[0 .. url.len + "ssh://".len];
return final;
}

return null;
}

pub fn tryHTTPS(url: string) ?string {
if (strings.hasPrefixComptime(url, "http")) {
return url;
}

if (strings.hasPrefixComptime(url, "ssh://")) {
final_path_buf[0.."https".len].* = "https".*;
bun.copy(u8, final_path_buf["https".len..], url["ssh".len..]);
return final_path_buf[0 .. url.len - "ssh".len + "https".len];
const out = final_path_buf[0 .. url.len - "ssh".len + "https".len];
return out;
}

if (Dependency.isSCPLikePath(url)) {
Expand All @@ -194,7 +264,8 @@ pub const Repository = extern struct {
bun.copy(u8, rest[colon..], tld);
rest[colon + tld.len] = '/';
bun.copy(u8, rest[colon + tld.len + 1 ..], url[colon + 1 ..]);
return final_path_buf[0 .. url.len + "https://".len + tld.len];
const out = final_path_buf[0 .. url.len + "https://".len + tld.len];
return out;
}
}

Expand All @@ -206,15 +277,7 @@ pub const Repository = extern struct {
return null;
}

pub fn download(
allocator: std.mem.Allocator,
env: *DotEnv.Loader,
log: *logger.Log,
cache_dir: std.fs.Dir,
task_id: u64,
name: string,
url: string,
) !std.fs.Dir {
pub fn download(allocator: std.mem.Allocator, env: *DotEnv.Loader, log: *logger.Log, cache_dir: std.fs.Dir, task_id: u64, name: string, url: string, attempt: u8) !std.fs.Dir {
bun.Analytics.Features.git_dependencies += 1;
const folder_name = try std.fmt.bufPrintZ(&folder_name_buf, "{any}.git", .{
bun.fmt.hexIntLower(task_id),
Expand Down Expand Up @@ -246,20 +309,24 @@ pub const Repository = extern struct {
_ = exec(allocator, env, &[_]string{
"git",
"clone",
"-c core.longpaths=true",
"--quiet",
"--bare",
url,
target,
}) catch |err| {
log.addErrorFmt(
null,
logger.Loc.Empty,
allocator,
"\"git clone\" for \"{s}\" failed",
.{name},
) catch unreachable;
if (err == error.RepositoryNotFound or attempt > 1) {
log.addErrorFmt(
null,
logger.Loc.Empty,
allocator,
"\"git clone\" for \"{s}\" failed",
.{name},
) catch unreachable;
}
return err;
};

break :clone try cache_dir.openDirZ(folder_name, .{});
};
}
Expand Down Expand Up @@ -319,6 +386,7 @@ pub const Repository = extern struct {
_ = exec(allocator, env, &[_]string{
"git",
"clone",
"-c core.longpaths=true",
"--quiet",
"--no-checkout",
try bun.getFdPath(repo_dir.fd, &final_path_buf),
Expand Down
36 changes: 36 additions & 0 deletions test/cli/install/bun-install.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4519,6 +4519,42 @@ it("should fail on invalid Git URL", async () => {
}
});

it("should fail on ssh Git URL if invalid credentials", async () => {
const urls: string[] = [];
setHandler(dummyRegistry(urls));
await writeFile(
join(package_dir, "package.json"),
JSON.stringify({
name: "Foo",
version: "0.0.1",
dependencies: {
"private-install": "git+ssh://git@bitbucket.org/kaizenmedia/private-install-test.git",
},
}),
);
const { stdout, stderr, exited } = spawn({
cmd: [bunExe(), "install"],
cwd: package_dir,
stdout: "pipe",
stdin: "pipe",
stderr: "pipe",
env,
Eckhardt-D marked this conversation as resolved.
Show resolved Hide resolved
});
const err = await new Response(stderr).text();
expect(err.split(/\r?\n/)).toContain('error: "git clone" for "private-install" failed');
const out = await new Response(stdout).text();
expect(out).toBeEmpty();
expect(await exited).toBe(1);
expect(urls.sort()).toBeEmpty();
expect(requested).toBe(0);
try {
await access(join(package_dir, "bun.lockb"));
expect(() => {}).toThrow();
} catch (err: any) {
expect(err.code).toBe("ENOENT");
}
});

it("should fail on Git URL with invalid committish", async () => {
const urls: string[] = [];
setHandler(dummyRegistry(urls));
Expand Down
Loading