package/pkg-golang: use 'build' instead of 'install'
PATCH 1/2 package/pkg-golang: use 'build' instead of 'install'
So far, we were using the 'go install' mechanism to build a package and have its binary installed in $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH). This worked fine when building on x86-64 for ARM, but failed when building on x86-64 for x86-64 because the binaries were installed in $$($(2)_WORKSPACE)/bin/.
Instead of doing some complicated logic to guess whether Go is going to put our binaries in $$($(2)_WORKSPACE)/bin/ or in $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH), we revert back to using "go build", as it was done before the introduction of the golang package infrastructure. "go build" lets us pass explicitly the destination path of the binary to be generated.
There's just one complexity with how to decide on the name of the binary that should be produced, and we have two cases:
- <pkg>_BUILD_TARGETS is the default, i.e ".". In this case we assume a single binary is produced by "go build", and we name if after the lower case package name. We allow this to be overridden thanks to <pkg>_BIN_NAME.
- <pkg>_BUILD_TARGETS is non-default, and typically contains something like "foo bar" or "cmd/foo cmd/bar". In this case, we assume the binaries to be produced are "foo" and "bar", i.e we take the non-directory part of the build target to name the binaries.
Because we're using this -o option, we no longer need to explicitly create the binary directory, it is done by "go build".
Fixes:
http://autobuild.buildroot.net/results/1f9cd7c48e8c8f41326632a9c0de83915d72c45b/
--- docs/manual/adding-packages-golang.txt | 13 ++++++++++++- package/pkg-golang.mk | 26 ++++++++++++++------------ 2 files changed, 26 insertions(+), 13 deletions(-)
docs/manual/adding-packages-golang.txt +12 -1
@@ -86,7 +86,18 @@ therefore only use a few of them, or none. * +FOO_BUILD_TARGETS+ can be used to pass the list of targets that should be built. If +FOO_BUILD_TARGETS+ is not specified, it - defaults to +.+. + defaults to +.+. We then have two cases: + +** +FOO_BUILD_TARGETS+ is +.+. In this case, we assume only one binary + will be produced, and that by default we name it after the package + name. If that is not appropriate, the name of the produced binary + can be overridden using +FOO_BIN_NAME+. + +** +FOO_BUILD_TARGETS+ is not +.+. In this case, we iterate over the + values to build each target, and for each produced a binary that is + the non-directory component of the target. For example if + +FOO_BUILD_TARGETS = cmd/docker cmd/dockerd+ the binaries produced + are +docker+ and +dockerd+. * +FOO_INSTALL_BINS+ can be used to pass the list of binaries that should be installed in +/usr/bin+ on the target. If
package/pkg-golang.mk +14 -12
@@ -62,12 +62,16 @@ $(2)_DEPENDENCIES += host-go $(2)_BUILD_TARGETS ?= . -$(2)_INSTALL_BINS ?= $(1) +# If the build target is just ".", then we assume the binary to be +# produced is named after the package. If however, a build target has +# been specified, we assume that the binaries to be produced are named +# after each build target building them (below in <pkg>_BUILD_CMDS). +ifeq ($$($(2)_BUILD_TARGETS),.) +$(2)_BIN_NAME ?= $(1) +endif -# The go build/install command installs the binaries inside -# gopath/bin/linux_GOARCH/ when cross compilation is enabled. We set this -# variable here to be used by packages if needed. -$(2)_BINDIR = $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH) +$(2)_BINDIR = bin +$(2)_INSTALL_BINS ?= $(1) # Source files in Go should be extracted in a precise folder in the hierarchy # of GOPATH. It usually resolves around domain/vendor/software. By default, we
@@ -84,17 +88,13 @@ $(2)_SRC_PATH = $$(@D)/$$($(2)_WORKSPACE)/src/$$($(2)_SRC_SUBDIR) # file. ifndef $(2)_CONFIGURE_CMDS define $(2)_CONFIGURE_CMDS - mkdir -p $$(@D)/$$($(2)_WORKSPACE)/bin mkdir -p $$(dir $$($(2)_SRC_PATH)) ln -sf $$(@D) $$($(2)_SRC_PATH) endef endif -# Build step. Only define it if not already defined by the package .mk file. We -# use the install command instead of build command here because the install -# command just moves the package binaries into <workspace>/bin/linux_GOARCH/. -# This leverages the go build infrastructure for building and installing -# multiple binaries. +# Build step. Only define it if not already defined by the package .mk +# file. ifndef $(2)_BUILD_CMDS define $(2)_BUILD_CMDS $$(foreach d,$$($(2)_BUILD_TARGETS),\
@@ -102,7 +102,9 @@ define $(2)_BUILD_CMDS $$(GO_TARGET_ENV) \ GOPATH="$$(@D)/$$($(2)_WORKSPACE)" \ $$($(2)_GO_ENV) \ - $$(GO_BIN) install -v $$($(2)_BUILD_OPTS) ./$$(d) + $$(GO_BIN) build -v $$($(2)_BUILD_OPTS) \ + -o $$(@D)/$$($(2)_BINDIR)/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \ + ./$$(d) ) endef endif
Signature · 1 line
2.14.3
PATCH 2/2 package/pkg-golang: drop the fixed <pkg>_BINDIR variable
Now that <pkg>_BINDIR is always "bin", having it as a package variable doesn't make much sense, so get rid of this variable completely, and use "bin".
--- package/docker-proxy/docker-proxy.mk | 2 +- package/flannel/flannel.mk | 2 +- package/pkg-golang.mk | 5 ++--- 3 files changed, 4 insertions(+), 5 deletions(-)
package/docker-proxy/docker-proxy.mk +1 -1
@@ -17,7 +17,7 @@ DOCKER_PROXY_WORKSPACE = gopath DOCKER_PROXY_BUILD_TARGETS = cmd/proxy define DOCKER_PROXY_INSTALL_TARGET_CMDS - $(INSTALL) -D -m 0755 $(@D)/$(DOCKER_PROXY_BINDIR)/proxy $(TARGET_DIR)/usr/bin/docker-proxy + $(INSTALL) -D -m 0755 $(@D)/bin/proxy $(TARGET_DIR)/usr/bin/docker-proxy endef $(eval $(golang-package))
package/flannel/flannel.mk +1 -1
@@ -15,7 +15,7 @@ FLANNEL_LDFLAGS = -X github.com/coreos/flannel/version.Version=$(FLANNEL_VERSION # Install flannel to its well known location. define FLANNEL_INSTALL_TARGET_CMDS - $(INSTALL) -D -m 0755 $(@D)/$(FLANNEL_BINDIR)/flannel $(TARGET_DIR)/opt/bin/flanneld + $(INSTALL) -D -m 0755 $(@D)/bin/flannel $(TARGET_DIR)/opt/bin/flanneld $(INSTALL) -D -m 0755 $(@D)/dist/mk-docker-opts.sh $(TARGET_DIR)/opt/bin/mk-docker-opts.sh endef
package/pkg-golang.mk +2 -3
@@ -70,7 +70,6 @@ ifeq ($$($(2)_BUILD_TARGETS),.) $(2)_BIN_NAME ?= $(1) endif -$(2)_BINDIR = bin $(2)_INSTALL_BINS ?= $(1) # Source files in Go should be extracted in a precise folder in the hierarchy
@@ -103,7 +102,7 @@ define $(2)_BUILD_CMDS GOPATH="$$(@D)/$$($(2)_WORKSPACE)" \ $$($(2)_GO_ENV) \ $$(GO_BIN) build -v $$($(2)_BUILD_OPTS) \ - -o $$(@D)/$$($(2)_BINDIR)/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \ + -o $$(@D)/bin/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \ ./$$(d) ) endef
@@ -114,7 +113,7 @@ endif ifndef $(2)_INSTALL_TARGET_CMDS define $(2)_INSTALL_TARGET_CMDS $$(foreach d,$$($(2)_INSTALL_BINS),\ - $(INSTALL) -D -m 0755 $$(@D)/$$($(2)_BINDIR)/$$(d) $(TARGET_DIR)/usr/bin/$$(d) + $(INSTALL) -D -m 0755 $$(@D)/bin/$$(d) $(TARGET_DIR)/usr/bin/$$(d) ) endef endif
Signature · 1 line
2.14.3
PATCH 2/2 package/pkg-golang: drop the fixed <pkg>_BINDIR variable
Thomas, All,
On 2018-04-01 13:51 +0200, Thomas Petazzoni spake thusly:
Quoted 5 lines
Now that <pkg>_BINDIR is always "bin", having it as a package variable doesn't make much sense, so get rid of this variable completely, and use "bin".
Signed-off-by Thomas Petazzoni <[email protected]>
Regards,
Yann E. MORIN.
Quoted 69 lines
--- package/docker-proxy/docker-proxy.mk | 2 +- package/flannel/flannel.mk | 2 +- package/pkg-golang.mk | 5 ++--- 3 files changed, 4 insertions(+), 5 deletions(-)package/docker-proxy/docker-proxy.mk +1
-1@@ -17,7 +17,7 @@ DOCKER_PROXY_WORKSPACE = gopath DOCKER_PROXY_BUILD_TARGETS = cmd/proxy define DOCKER_PROXY_INSTALL_TARGET_CMDS - $(INSTALL) -D -m 0755 $(@D)/$(DOCKER_PROXY_BINDIR)/proxy $(TARGET_DIR)/usr/bin/docker-proxy + $(INSTALL) -D -m 0755 $(@D)/bin/proxy $(TARGET_DIR)/usr/bin/docker-proxy endef $(eval $(golang-package))package/flannel/flannel.mk +1
-1@@ -15,7 +15,7 @@ FLANNEL_LDFLAGS = -X github.com/coreos/flannel/version.Version=$(FLANNEL_VERSION # Install flannel to its well known location. define FLANNEL_INSTALL_TARGET_CMDS - $(INSTALL) -D -m 0755 $(@D)/$(FLANNEL_BINDIR)/flannel $(TARGET_DIR)/opt/bin/flanneld + $(INSTALL) -D -m 0755 $(@D)/bin/flannel $(TARGET_DIR)/opt/bin/flanneld $(INSTALL) -D -m 0755 $(@D)/dist/mk-docker-opts.sh $(TARGET_DIR)/opt/bin/mk-docker-opts.sh endefpackage/pkg-golang.mk +2
-3@@ -70,7 +70,6 @@ ifeq ($$($(2)_BUILD_TARGETS),.) $(2)_BIN_NAME ?= $(1) endif -$(2)_BINDIR = bin $(2)_INSTALL_BINS ?= $(1) # Source files in Go should be extracted in a precise folder in the hierarchy@@ -103,7 +102,7 @@ define $(2)_BUILD_CMDS GOPATH="$$(@D)/$$($(2)_WORKSPACE)" \ $$($(2)_GO_ENV) \ $$(GO_BIN) build -v $$($(2)_BUILD_OPTS) \ - -o $$(@D)/$$($(2)_BINDIR)/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \ + -o $$(@D)/bin/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \ ./$$(d) ) endef@@ -114,7 +113,7 @@ endif ifndef $(2)_INSTALL_TARGET_CMDS define $(2)_INSTALL_TARGET_CMDS $$(foreach d,$$($(2)_INSTALL_BINS),\ - $(INSTALL) -D -m 0755 $$(@D)/$$($(2)_BINDIR)/$$(d) $(TARGET_DIR)/usr/bin/$$(d) + $(INSTALL) -D -m 0755 $$(@D)/bin/$$(d) $(TARGET_DIR)/usr/bin/$$(d) ) endef endifSignature · 6 lines
2.14.3 _______________________________________________ buildroot mailing list buildroot at busybox.net http://lists.busybox.net/mailman/listinfo/buildroot
Signature · 6 lines
.-----------------.--------------------.------------------.--------------------. | Yann E. MORIN | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: | | +33 662 376 056 | Software Designer | \ / CAMPAIGN | ___ | | +33 223 225 172 `------------.-------: X AGAINST | \e/ There is no | | http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL | v conspiracy. | '------------------------------^-------^------------------^--------------------'
PATCH 2/2 package/pkg-golang: drop the fixed <pkg>_BINDIR variable
In reply to Thomas PetazzoniQuoted 7 lines
Quoted 1 line
Quoted 1 line
Quoted 1 line
Quoted 1 line
"Thomas" == Thomas Petazzoni <[email protected]> writes:
Now that <pkg>_BINDIR is always "bin", having it as a package variable doesn't make much sense, so get rid of this variable completely, and use "bin".
Signed-off-by Thomas Petazzoni <[email protected]>
Committed, thanks.
Signature · 1 line
Bye, Peter Korsgaard
PATCH 1/2 package/pkg-golang: use 'build' instead of 'install'
In reply to Thomas PetazzoniThomas, All,
On 2018-04-01 13:51 +0200, Thomas Petazzoni spake thusly:
Quoted 26 lines
So far, we were using the 'go install' mechanism to build a package and have its binary installed in $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH). This worked fine when building on x86-64 for ARM, but failed when building on x86-64 for x86-64 because the binaries were installed in $$($(2)_WORKSPACE)/bin/.
Instead of doing some complicated logic to guess whether Go is going to put our binaries in $$($(2)_WORKSPACE)/bin/ or in $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH), we revert back to using "go build", as it was done before the introduction of the golang package infrastructure. "go build" lets us pass explicitly the destination path of the binary to be generated.
There's just one complexity with how to decide on the name of the binary that should be produced, and we have two cases:
- <pkg>_BUILD_TARGETS is the default, i.e ".". In this case we assume a single binary is produced by "go build", and we name if after the lower case package name. We allow this to be overridden thanks to <pkg>_BIN_NAME.
- <pkg>_BUILD_TARGETS is non-default, and typically contains something like "foo bar" or "cmd/foo cmd/bar". In this case, we assume the binaries to be produced are "foo" and "bar", i.e we take the non-directory part of the build target to name the binaries.
Quoted 8 lines
Because we're using this -o option, we no longer need to explicitly create the binary directory, it is done by "go build".
Fixes:
http://autobuild.buildroot.net/results/1f9cd7c48e8c8f41326632a9c0de83915d72c45b/
Signed-off-by Thomas Petazzoni <[email protected]>
Regards,
Yann E. MORIN.
Quoted 93 lines
--- docs/manual/adding-packages-golang.txt | 13 ++++++++++++- package/pkg-golang.mk | 26 ++++++++++++++------------ 2 files changed, 26 insertions(+), 13 deletions(-)docs/manual/adding-packages-golang.txt +12
-1@@ -86,7 +86,18 @@ therefore only use a few of them, or none. * +FOO_BUILD_TARGETS+ can be used to pass the list of targets that should be built. If +FOO_BUILD_TARGETS+ is not specified, it - defaults to +.+. + defaults to +.+. We then have two cases: + +** +FOO_BUILD_TARGETS+ is +.+. In this case, we assume only one binary + will be produced, and that by default we name it after the package + name. If that is not appropriate, the name of the produced binary + can be overridden using +FOO_BIN_NAME+. + +** +FOO_BUILD_TARGETS+ is not +.+. In this case, we iterate over the + values to build each target, and for each produced a binary that is + the non-directory component of the target. For example if + +FOO_BUILD_TARGETS = cmd/docker cmd/dockerd+ the binaries produced + are +docker+ and +dockerd+. * +FOO_INSTALL_BINS+ can be used to pass the list of binaries that should be installed in +/usr/bin+ on the target. Ifpackage/pkg-golang.mk +14
-12@@ -62,12 +62,16 @@ $(2)_DEPENDENCIES += host-go $(2)_BUILD_TARGETS ?= . -$(2)_INSTALL_BINS ?= $(1) +# If the build target is just ".", then we assume the binary to be +# produced is named after the package. If however, a build target has +# been specified, we assume that the binaries to be produced are named +# after each build target building them (below in <pkg>_BUILD_CMDS). +ifeq ($$($(2)_BUILD_TARGETS),.) +$(2)_BIN_NAME ?= $(1) +endif -# The go build/install command installs the binaries inside -# gopath/bin/linux_GOARCH/ when cross compilation is enabled. We set this -# variable here to be used by packages if needed. -$(2)_BINDIR = $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH) +$(2)_BINDIR = bin +$(2)_INSTALL_BINS ?= $(1) # Source files in Go should be extracted in a precise folder in the hierarchy # of GOPATH. It usually resolves around domain/vendor/software. By default, we@@ -84,17 +88,13 @@ $(2)_SRC_PATH = $$(@D)/$$($(2)_WORKSPACE)/src/$$($(2)_SRC_SUBDIR) # file. ifndef $(2)_CONFIGURE_CMDS define $(2)_CONFIGURE_CMDS - mkdir -p $$(@D)/$$($(2)_WORKSPACE)/bin mkdir -p $$(dir $$($(2)_SRC_PATH)) ln -sf $$(@D) $$($(2)_SRC_PATH) endef endif -# Build step. Only define it if not already defined by the package .mk file. We -# use the install command instead of build command here because the install -# command just moves the package binaries into <workspace>/bin/linux_GOARCH/. -# This leverages the go build infrastructure for building and installing -# multiple binaries. +# Build step. Only define it if not already defined by the package .mk +# file. ifndef $(2)_BUILD_CMDS define $(2)_BUILD_CMDS $$(foreach d,$$($(2)_BUILD_TARGETS),\@@ -102,7 +102,9 @@ define $(2)_BUILD_CMDS $$(GO_TARGET_ENV) \ GOPATH="$$(@D)/$$($(2)_WORKSPACE)" \ $$($(2)_GO_ENV) \ - $$(GO_BIN) install -v $$($(2)_BUILD_OPTS) ./$$(d) + $$(GO_BIN) build -v $$($(2)_BUILD_OPTS) \ + -o $$(@D)/$$($(2)_BINDIR)/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \ + ./$$(d) ) endef endifSignature · 6 lines
2.14.3 _______________________________________________ buildroot mailing list buildroot at busybox.net http://lists.busybox.net/mailman/listinfo/buildroot
Signature · 6 lines
.-----------------.--------------------.------------------.--------------------. | Yann E. MORIN | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: | | +33 662 376 056 | Software Designer | \ / CAMPAIGN | ___ | | +33 223 225 172 `------------.-------: X AGAINST | \e/ There is no | | http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL | v conspiracy. | '------------------------------^-------^------------------^--------------------'
PATCH 1/2 package/pkg-golang: use 'build' instead of 'install'
In reply to Thomas PetazzoniMinor nit...
package/pkg-golang.mk define $(2)_BUILD_CMDS · line 106
Quoted 7 lines · Thomas Petazzoni
package/pkg-golang.mk +2
-1@@ -102,7 +102,9 @@ define $(2)_BUILD_CMDS $$(GO_TARGET_ENV) \ GOPATH="$$(@D)/$$($(2)_WORKSPACE)" \ $$($(2)_GO_ENV) \ - $$(GO_BIN) install -v $$($(2)_BUILD_OPTS) ./$$(d) + $$(GO_BIN) build -v $$($(2)_BUILD_OPTS) \ + -o $$(@D)/$$($(2)_BINDIR)/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \
I find the $(or ...) construct to be more readable:
-o $$(@D)/$$($(2)_BINDIR)/$$(or $$($(2)_BIN_NAME),$$(notdir $$(d))) \
Regards,
Arnout
Quoted 4 lines
package/pkg-golang.mk +1
-0+ ./$$(d) ) endef endif
Signature · 6 lines
Arnout Vandecappelle arnout at mind be Senior Embedded Software Architect +32-16-286500 Essensium/Mind http://www.mind.be G.Geenslaan 9, 3001 Leuven, Belgium BE 872 984 063 RPR Leuven LinkedIn profile: http://www.linkedin.com/in/arnoutvandecappelle GPG fingerprint: 7493 020B C7E3 8618 8DEC 222C 82EB F404 F9AC 0DDF
PATCH 1/2 package/pkg-golang: use 'build' instead of 'install'
Quoted 14 lines
Quoted 1 line
Quoted 1 line
Quoted 1 line
Quoted 1 line
"Arnout" == Arnout Vandecappelle <[email protected]> writes:
Minor nit...
package/pkg-golang.mk define $(2)_BUILD_CMDS · line 106
Quoted 7 lines · Thomas Petazzoni
package/pkg-golang.mk +2
-1@@ -102,7 +102,9 @@ define $(2)_BUILD_CMDS $$(GO_TARGET_ENV) \ GOPATH="$$(@D)/$$($(2)_WORKSPACE)" \ $$($(2)_GO_ENV) \ - $$(GO_BIN) install -v $$($(2)_BUILD_OPTS) ./$$(d) + $$(GO_BIN) build -v $$($(2)_BUILD_OPTS) \ + -o $$(@D)/$$($(2)_BINDIR)/$$(if $$($(2)_BIN_NAME),$$($(2)_BIN_NAME),$$(notdir $$(d))) \I find the $(or ...) construct to be more readable:
Quoted 1 line
-o $$(@D)/$$($(2)_BINDIR)/$$(or $$($(2)_BIN_NAME),$$(notdir $$(d))) \
We do use a lot more $(if than $(or, but OK - $(or is shorter.
Signature · 1 line
Bye, Peter Korsgaard
PATCH 1/2 package/pkg-golang: use 'build' instead of 'install'
In reply to Thomas PetazzoniQuoted 28 lines
Quoted 1 line
Quoted 1 line
Quoted 1 line
Quoted 1 line
"Thomas" == Thomas Petazzoni <[email protected]> writes:
So far, we were using the 'go install' mechanism to build a package and have its binary installed in $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH). This worked fine when building on x86-64 for ARM, but failed when building on x86-64 for x86-64 because the binaries were installed in $$($(2)_WORKSPACE)/bin/.
Instead of doing some complicated logic to guess whether Go is going to put our binaries in $$($(2)_WORKSPACE)/bin/ or in $$($(2)_WORKSPACE)/bin/linux_$$(GO_GOARCH), we revert back to using "go build", as it was done before the introduction of the golang package infrastructure. "go build" lets us pass explicitly the destination path of the binary to be generated.
There's just one complexity with how to decide on the name of the binary that should be produced, and we have two cases:
- <pkg>_BUILD_TARGETS is the default, i.e ".". In this case we assume a single binary is produced by "go build", and we name if after the lower case package name. We allow this to be overridden thanks to <pkg>_BIN_NAME.
- <pkg>_BUILD_TARGETS is non-default, and typically contains something like "foo bar" or "cmd/foo cmd/bar". In this case, we assume the binaries to be produced are "foo" and "bar", i.e we take the non-directory part of the build target to name the binaries.
Quoted 8 lines
Because we're using this -o option, we no longer need to explicitly create the binary directory, it is done by "go build".
Fixes:
http://autobuild.buildroot.net/results/1f9cd7c48e8c8f41326632a9c0de83915d72c45b/
Signed-off-by Thomas Petazzoni <[email protected]>
Committed after changing the logic to use $(if as suggested by Arnout, thanks.
Signature · 1 line
Bye, Peter Korsgaard