YARN-9245. Added query docker image command ability to node manager.

Contributed by Chandni Singh
This commit is contained in:
Eric Yang 2019-02-27 14:57:24 -05:00
parent fef2e2fc88
commit fbc7bb315f
5 changed files with 174 additions and 0 deletions

View File

@ -0,0 +1,38 @@
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.hadoop.yarn.server.nodemanager.containermanager.linux.runtime.docker;
import com.google.common.base.Preconditions;
/**
* Encapsulates the docker images command and its command
* line arguments.
*/
public class DockerImagesCommand extends DockerCommand {
private static final String IMAGES_COMMAND = "images";
public DockerImagesCommand() {
super(IMAGES_COMMAND);
}
public DockerImagesCommand getSingleImageStatus(String imageName) {
Preconditions.checkNotNull(imageName, "imageName");
super.addCommandArguments("image", imageName);
return this;
}
}

View File

@ -458,6 +458,8 @@ int get_docker_command(const char *command_file, const struct configuration *con
ret = get_docker_start_command(command_file, conf, args); ret = get_docker_start_command(command_file, conf, args);
} else if (strcmp(DOCKER_EXEC_COMMAND, command) == 0) { } else if (strcmp(DOCKER_EXEC_COMMAND, command) == 0) {
ret = get_docker_exec_command(command_file, conf, args); ret = get_docker_exec_command(command_file, conf, args);
} else if (strcmp(DOCKER_IMAGES_COMMAND, command) == 0) {
ret = get_docker_images_command(command_file, conf, args);
} else { } else {
ret = UNKNOWN_DOCKER_COMMAND; ret = UNKNOWN_DOCKER_COMMAND;
} }
@ -1736,3 +1738,39 @@ free_and_exit:
free_configuration(&command_config); free_configuration(&command_config);
return ret; return ret;
} }
int get_docker_images_command(const char *command_file, const struct configuration *conf, args *args) {
int ret = 0;
char *image_name = NULL;
struct configuration command_config = {0, NULL};
ret = read_and_verify_command_file(command_file, DOCKER_IMAGES_COMMAND, &command_config);
if (ret != 0) {
goto free_and_exit;
}
ret = add_to_args(args, DOCKER_IMAGES_COMMAND);
if (ret != 0) {
goto free_and_exit;
}
image_name = get_configuration_value("image", DOCKER_COMMAND_FILE_SECTION, &command_config);
if (image_name) {
if (validate_docker_image_name(image_name) != 0) {
ret = INVALID_DOCKER_IMAGE_NAME;
goto free_and_exit;
}
ret = add_to_args(args, image_name);
if (ret != 0) {
goto free_and_exit;
}
}
ret = add_to_args(args, "--format={{json .}}");
ret = add_to_args(args, "--filter=dangling=false");
free_and_exit:
free(image_name);
free_configuration(&command_config);
return ret;
}

View File

@ -35,6 +35,7 @@
#define DOCKER_VOLUME_COMMAND "volume" #define DOCKER_VOLUME_COMMAND "volume"
#define DOCKER_START_COMMAND "start" #define DOCKER_START_COMMAND "start"
#define DOCKER_EXEC_COMMAND "exec" #define DOCKER_EXEC_COMMAND "exec"
#define DOCKER_IMAGES_COMMAND "images"
#define DOCKER_ARG_MAX 1024 #define DOCKER_ARG_MAX 1024
#define ARGS_INITIAL_VALUE { 0 }; #define ARGS_INITIAL_VALUE { 0 };
@ -219,4 +220,15 @@ char** extract_execv_args(args *args);
* @return value of max retries * @return value of max retries
*/ */
int get_max_retries(const struct configuration *conf); int get_max_retries(const struct configuration *conf);
/**
* Get the Docker images command line string. The function will verify that the params file is meant for the images
* command.
* @param command_file File containing the params for the Docker images command
* @param conf Configuration struct containing the container-executor.cfg details
* @param args Buffer to construct argv
* @return Return code with 0 indicating success and non-zero codes indicating error
*/
int get_docker_images_command(const char* command_file, const struct configuration* conf, args *args);
#endif #endif

View File

@ -1962,4 +1962,28 @@ namespace ContainerExecutor {
} }
free_configuration(&container_cfg); free_configuration(&container_cfg);
} }
TEST_F(TestDockerUtil, test_docker_images) {
std::vector<std::pair<std::string, std::string> > file_cmd_vec;
file_cmd_vec.push_back(std::make_pair<std::string, std::string>(
"[docker-command-execution]\n docker-command=images",
"images --format={{json .}} --filter=dangling=false"));
file_cmd_vec.push_back(std::make_pair<std::string, std::string>(
"[docker-command-execution]\n docker-command=images\n image=image-id",
"images image-id --format={{json .}} --filter=dangling=false"));
std::vector<std::pair<std::string, int> > bad_file_cmd_vec;
bad_file_cmd_vec.push_back(std::make_pair<std::string, int>(
"[docker-command-execution]\n docker-command=run\n image=image-id",
static_cast<int>(INCORRECT_COMMAND)));
bad_file_cmd_vec.push_back(std::make_pair<std::string, int>(
"docker-command=images\n image=image-id",
static_cast<int>(INCORRECT_COMMAND)));
run_docker_command_test(file_cmd_vec, bad_file_cmd_vec,
get_docker_images_command);
free_configuration(&container_executor_cfg);
}
} }

View File

@ -0,0 +1,62 @@
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.hadoop.yarn.server.nodemanager.containermanager.linux.runtime.docker;
import org.apache.hadoop.util.StringUtils;
import org.junit.Before;
import org.junit.Test;
import static org.junit.Assert.assertEquals;
/**
* Tests the docker images command and its command
* line arguments.
*/
public class TestDockerImagesCommand {
private DockerImagesCommand dockerImagesCommand;
private static final String IMAGE_NAME = "foo";
@Before
public void setup() {
dockerImagesCommand = new DockerImagesCommand();
}
@Test
public void testGetCommandOption() {
assertEquals("images", dockerImagesCommand.getCommandOption());
}
@Test
public void testAllImages() {
assertEquals("images", StringUtils.join(",",
dockerImagesCommand.getDockerCommandWithArguments()
.get("docker-command")));
assertEquals(1, dockerImagesCommand.getDockerCommandWithArguments().size());
}
@Test
public void testSingleImage() {
dockerImagesCommand = dockerImagesCommand.getSingleImageStatus(IMAGE_NAME);
assertEquals("images", StringUtils.join(",",
dockerImagesCommand.getDockerCommandWithArguments()
.get("docker-command")));
assertEquals("image name", "foo", StringUtils.join(",",
dockerImagesCommand.getDockerCommandWithArguments().get("image")));
assertEquals(2, dockerImagesCommand.getDockerCommandWithArguments().size());
}
}